Exclude Removed Entities

This page is also available in Ukrainian.

Overview

All Google Ads listing endpoints now return REMOVED entities (deleted campaigns, ad groups, ads, keywords) by default. To hide them, pass ?exclude_removed=true. This is a non-breaking change — existing responses now include additional rows with status: "REMOVED". The old behavior is available via opt-out.

How to use

Add ?exclude_removed=true to any listing endpoint to restore previous filtering:

GET /api/v1/google-ads/{customer_id}/ad-groups?exclude_removed=true
GET /api/v1/google-ads/{customer_id}/keywords?exclude_removed=true

Omitting the parameter (or exclude_removed=false) returns everything, including REMOVED entities.

Parameter

Property	Value
Name	`exclude_removed`
Type	`bool` (optional)
Default	`false`

Affected endpoints

Endpoint	What gets filtered when `true`
`/campaigns`	removed campaigns
`/campaigns/csv`	removed campaigns
`/ad-groups`	removed ad groups
`/ad-groups/csv`	removed ad groups
`/ads`	removed campaigns, ad groups, and ads
`/ads/csv`	removed campaigns, ad groups, and ads
`/keywords`	removed campaigns, ad groups, and keywords
`/keywords/csv`	removed campaigns, ad groups, and keywords
`/search-terms`	removed campaigns and ad groups
`/search-terms/csv`	removed campaigns and ad groups
`/assets`	removed campaigns
`/ad-schedule`	removed campaigns
`/ad-schedule/csv`	removed campaigns
`/locations`	removed campaigns

Frontend integration

Quick (preserve old behavior)
Recommended (show REMOVED)

Add &exclude_removed=true to all listing API calls. Nothing else changes.

const params = {
  customer_id: customerId,
  start_date: startDate,
  end_date: endDate,
  exclude_removed: true, // ← add this
};

Remove the parameter (or leave it false) and handle status: "REMOVED" in your table rendering — e.g., gray out the row or show a badge.

// No exclude_removed param needed — REMOVED entities are included
const params = {
  customer_id: customerId,
  start_date: startDate,
  end_date: endDate,
};

Getting started

Customization

Writing content

AI tools

Google Ads

Companies

Campaigns

Exclude Removed Entities

Overview

How to use

Parameter

Affected endpoints

Frontend integration

​Overview

​How to use

​Parameter

​Affected endpoints

​Frontend integration

Overview

How to use

Parameter

Affected endpoints

Frontend integration