从受众群体中移除所有成员

本指南介绍了如何通过发送 RemoveAllAudienceMembersRequest 从目标客户匹配受众群体中移除所有成员。

如果您需要通过单个请求清除用户名单或替换名单的所有受众群体成员，此方法会很有用。

清除受众群体

如需从受众群体中移除所有成员，请发送 RemoveAllAudienceMembersRequest 并省略 removeAsOfTime 字段。此操作会将移除时间默认设置为当前时间，并从列表中清除所有当前成员。

替换所有成员

如需替换目标客户匹配受众群体中的所有成员，同时避免出现空的用户名单，请按以下步骤操作：

  1. 将当前时间记录为 T。
  2. 通过发送 IngestAudienceMembersRequest 开始上传新成员。 如果需要，您可以发出多项提取请求。

  3. 等待所有提取请求处理完毕。您可以使用诊断检查请求的状态。

  4. 发送 RemoveAllAudienceMembersRequest，并将 removeAsOfTime 设置为在第 1 步中记录的时间戳 T。此操作只会移除在您开始上传新成员之前添加的成员，仅保留新添加的成员。

构建请求

在 RemoveAllAudienceMembersRequest 正文中设置以下字段：

destinations
必需。目的地列表。每个目标平台中的 productDestinationId 字段用于指定要从中移除成员的受众群体。如需了解详情，请参阅配置目的地。
removeAsOfTime
可选。系统只会移除在此时间之前添加的成员。 如需了解格式设置详情，请参阅时间戳格式。如果未设置，则此值默认为当前时间。
validateOnly
可选。设置为 true 可验证请求，但不应用更改。准备好应用更改后，请将此值设置为 false。

采样请求

以下示例请求会从目标客户匹配名单中移除所有会员。

  1. 点击在 API Explorer 中打开，即可在新标签页或窗口中打开 API Explorer。
  2. 在 API 浏览器中的请求正文中，将以 REPLACE_WITH 开头的每个字符串（例如 REPLACE_WITH_OPERATING_ACCOUNT_TYPE）替换为相关值。
  3. 点击 API 浏览器页面底部的执行，然后完成授权提示以发送请求。
  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"
}

如果请求失败，请检查错误以确定失败原因。

上一页
查看上传结果