> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cattix.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Opt-out фільтр для приховування REMOVED сутностей Google Ads з ендпоінтів списків

<Note>
  This page is also available in [English](/guides/exclude-removed).
</Note>

## Огляд

Усі ендпоінти списків 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`        | видалені кампанії                                   |

***

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

<Tabs>
  <Tab title="Швидко (зберегти стару поведінку)">
    Додайте `&exclude_removed=true` до всіх API-викликів списків. Більше нічого
    не змінюється.

    ```typescript theme={null}
    const params = {
      customer_id: customerId,
      start_date: startDate,
      end_date: endDate,
      exclude_removed: true, // ← додайте це
    };
    ```
  </Tab>

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

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