Удалите всех зрителей из зала.

В этом руководстве объясняется, как удалить всех участников из аудитории Customer Match, отправив запрос RemoveAllAudienceMembersRequest .

Этот метод полезен, если вам нужно очистить список пользователей одним запросом или заменить всех участников аудитории в списке.

Уберите зрителей

Чтобы удалить всех участников из списка аудитории, отправьте запрос RemoveAllAudienceMembersRequest , опустив поле removeAsOfTime . В этом случае время удаления будет установлено на текущее время, и все текущие участники будут удалены из списка.

Заменить всех участников

Чтобы заменить всех участников в аудитории Customer Match, избежав при этом создания пустого списка пользователей, выполните следующие действия:

  1. Запишите текущее время как T.
  2. Начните загрузку новых участников , отправив запрос IngestAudienceMembersRequest . При необходимости вы можете отправить несколько запросов на загрузку.

  3. Дождитесь завершения обработки всех запросов на прием данных. Проверить статус запросов можно с помощью раздела «Диагностика» .

  4. Отправьте запрос RemoveAllAudienceMembersRequest с removeAsOfTime , установленным на временную метку T , записанную на шаге #1. Это удалит только тех участников, которые были добавлены до начала загрузки новых участников, оставив только недавно добавленных участников.

Составьте запрос

В теле запроса RemoveAllAudienceMembersRequest необходимо указать следующие поля:

destinations
Обязательно . Список целевых аудиторий. Поле productDestinationId в каждой целевой аудитории указывает, из какой аудитории вы хотите удалить участников. Дополнительную информацию см. в разделе «Настройка целевых аудиторий» .
removeAsOfTime
Необязательно. Удалены будут только участники, добавленные до этого времени. Подробности форматирования см. в разделе «Формат временной метки» . Если не задано, по умолчанию используется текущее время.
validateOnly
Необязательно. Установите значение true , чтобы проверить запрос без применения изменений. Когда будете готовы применить изменения, установите значение false .

Примеры запросов

Вот пример запроса, который удаляет всех участников из списка совпадений клиентов.

  1. Нажмите «Открыть в API Explorer» , чтобы открыть API Explorer в новой вкладке или окне.
  2. В теле запроса в API Explorer замените каждую строку, начинающуюся с REPLACE_WITH , например REPLACE_WITH_OPERATING_ACCOUNT_TYPE , соответствующим значением.
  3. Нажмите кнопку «Выполнить» в нижней части страницы API Explorer и заполните запросы на авторизацию, чтобы отправить запрос.
  4. Установите validateOnly в true , чтобы проверить запрос без применения изменений. Когда вы будете готовы применить изменения, установите validateOnly в false .

Рекламодатель

Открыть в API Explorer 
{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "LOGIN_ACCOUNT_TYPE",
                "accountId": "LOGIN_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

Партнер по данным

Открыть в API Explorer 
{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "DATA_PARTNER",
                "accountId": "DATA_PARTNER_ACCOUNT_ID"
            },
            "linkedAccount": {
                "accountType": "LINKED_ACCOUNT_TYPE",
                "accountId": "LINKED_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

Отправить запрос

Отправьте запрос на конечную точку removeAll .

Если запрос выполнен успешно, ответ содержит идентификатор requestId , который можно использовать для отслеживания статуса операции .

{
  "requestId": "REQUEST_ID"
}

Если запрос не выполнен, проанализируйте ошибки , чтобы определить причину сбоя.

Назад
Проверьте результаты загрузки