Виключення видалених сутностей

This page is also available in English.

Огляд

Усі ендпоінти списків Google Ads тепер повертають REMOVED сутності (видалені кампанії, групи оголошень, оголошення, ключові слова) за замовчуванням. Щоб приховати їх, передайте ?exclude_removed=true. Це зворотно сумісна зміна — існуючі відповіді тепер містять додаткові рядки зі status: "REMOVED". Стара поведінка доступна через opt-out.

Як використовувати

Додайте ?exclude_removed=true до будь-якого ендпоінта списку, щоб повернути попередню фільтрацію:

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

Якщо параметр не вказано (або exclude_removed=false), повертається все, включаючи REMOVED сутності.

Параметр

Властивість	Значення
Назва	`exclude_removed`
Тип	`bool` (опціональний)
За замовчуванням	`false`

Ендпоінти, на які впливає

Ендпоінт	Що фільтрується при `true`
`/campaigns`	видалені кампанії
`/campaigns/csv`	видалені кампанії
`/ad-groups`	видалені групи оголошень
`/ad-groups/csv`	видалені групи оголошень
`/ads`	видалені кампанії, групи оголошень та оголошення
`/ads/csv`	видалені кампанії, групи оголошень та оголошення
`/keywords`	видалені кампанії, групи оголошень та ключові слова
`/keywords/csv`	видалені кампанії, групи оголошень та ключові слова
`/search-terms`	видалені кампанії та групи оголошень
`/search-terms/csv`	видалені кампанії та групи оголошень
`/assets`	видалені кампанії
`/ad-schedule`	видалені кампанії
`/ad-schedule/csv`	видалені кампанії
`/locations`	видалені кампанії

Інтеграція на фронтенді

Швидко (зберегти стару поведінку)
Рекомендовано (показувати REMOVED)

Додайте &exclude_removed=true до всіх API-викликів списків. Більше нічого не змінюється.

const params = {
  customer_id: customerId,
  start_date: startDate,
  end_date: endDate,
  exclude_removed: true, // ← додайте це
};

Приберіть параметр (або залиште false) та обробіть status: "REMOVED" у рендерингу таблиці — наприклад, зробіть рядок сірим або покажіть бейдж.

// Параметр exclude_removed не потрібен — REMOVED сутності включені
const params = {
  customer_id: customerId,
  start_date: startDate,
  end_date: endDate,
};

Getting started

Customization

Writing content

AI tools

Google Ads

Companies

Campaigns

Виключення видалених сутностей

Огляд

Як використовувати

Параметр

Ендпоінти, на які впливає

Інтеграція на фронтенді

​Огляд

​Як використовувати

​Параметр

​Ендпоінти, на які впливає

​Інтеграція на фронтенді

Огляд

Як використовувати

Параметр

Ендпоінти, на які впливає

Інтеграція на фронтенді