Skip to main content
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

PropertyValue
Nameexclude_removed
Typebool (optional)
Defaultfalse

​
Affected endpoints

EndpointWhat gets filtered when true
/campaignsremoved campaigns
/campaigns/csvremoved campaigns
/ad-groupsremoved ad groups
/ad-groups/csvremoved ad groups
/adsremoved campaigns, ad groups, and ads
/ads/csvremoved campaigns, ad groups, and ads
/keywordsremoved campaigns, ad groups, and keywords
/keywords/csvremoved campaigns, ad groups, and keywords
/search-termsremoved campaigns and ad groups
/search-terms/csvremoved campaigns and ad groups
/assetsremoved campaigns
/ad-scheduleremoved campaigns
/ad-schedule/csvremoved campaigns
/locationsremoved campaigns

​
Frontend integration

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
};