Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

オーディエンスからすべてのメンバーを削除する

このガイドでは、カスタマーマッチオーディエンスからすべてのメンバーを削除する方法について説明します RemoveAllAudienceMembersRequest。

この方法は、1 つのリクエストでユーザーリストをクリアする場合や、リストのすべてのオーディエンスメンバーを置き換える場合に便利です。

オーディエンスをクリアする

オーディエンスからすべてのメンバーを削除するには、 RemoveAllAudienceMembersRequest を送信し、 removeAsOfTime フィールドを省略します。これにより、削除時間がデフォルトで現在の時刻に設定され、現在のすべてのメンバーがリストからクリアされます。

すべてのメンバーを置き換える

ユーザーリストを空にせずにカスタマーマッチオーディエンスのすべてのメンバーを置き換えるには、次の操作を行います。

現在の時刻を T として記録します。
新しいメンバーのアップロードを送信して開始しますIngestAudienceMembersRequest。必要に応じて、複数の取り込みリクエストを行うことができます。
すべての取り込みリクエストの処理が完了するまで待ちます。リクエストのステータスは、診断を使用して確認できます。

注: ユーザーリストが一時的に空になっても問題ない場合は、この手順をスキップして手順 4 に進みます。取り込みリクエストのステータスを確認して、正常に処理されたことを確認することをおすすめします。
手順 1 で記録したタイムスタンプ T に removeAsOfTime を設定して、RemoveAllAudienceMembersRequest を送信します。これにより、新しいメンバーのアップロードを開始する前に追加されたメンバーのみが削除され、新しく追加されたメンバーのみが残ります。

リクエストを作成する

RemoveAllAudienceMembersRequest の本文で次のフィールドを設定します。

destinations: 必須。宛先のリスト。各宛先の productDestinationId フィールドは、メンバーを削除するオーディエンスを指定します。詳細については、宛先を構成するをご覧ください。
removeAsOfTime: 省略可。この時刻より前に追加されたメンバーのみが削除されます。形式の詳細については、タイムスタンプ形式をご覧ください。設定しない場合、この値はデフォルトで現在の時刻になります。
validateOnly: 省略可。変更を適用せずにリクエストを検証するには、true に設定します。変更を適用する準備ができたら、false に設定します。

サンプルリクエスト

カスタマーマッチリストからすべてのメンバーを削除するリクエストのサンプルを次に示します。

[API Explorer で開く] をクリックして、新しいタブまたはウィンドウで API Explorer を開きます。
API Explorer のリクエスト本文で、REPLACE_WITH_OPERATING_ACCOUNT_TYPE など、 REPLACE_WITH で始まる各文字列を適切な値に置き換えます。
API Explorer ページの下部にある [実行] をクリックし、認証プロンプトに沿ってリクエストを送信します。
変更を適用せずにリクエストを検証するには、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"
}

リクエストが失敗した場合は、エラーを調べて失敗の原因を特定します。

アップロード結果を確認する