Как удалить всех участников из аудитории

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

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

Как очистить аудиторию

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

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

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

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.

{
    "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
}

{
    "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"
}

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