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

В этом руководстве рассказывается, как удалить всех пользователей из аудитории на основе списка электронных адресов, отправив запрос 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. Нажмите Execute (Выполнить) внизу страницы 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"
}

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