從目標對象中移除所有成員

本指南說明如何傳送 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 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"
}

如果要求失敗，請檢查錯誤，找出失敗原因。

上一頁
查看上傳結果