2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
Method: firstAndThirdPartyAudiences.editCustomerMatchMembers
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
カスタマー マッチ オーディエンスのメンバーリストを更新します。
次の audienceType
でのみサポートされます。
CUSTOMER_MATCH_CONTACT_INFO
CUSTOMER_MATCH_DEVICE_ID
HTTP リクエスト
POST https://displayvideo.googleapis.com/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
firstAndThirdPartyAudienceId |
string (int64 format)
必須。メンバーを編集するカスタマー マッチの FirstAndThirdPartyAudience の ID。
|
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
{
"advertiserId": string,
// Union field added_members can be only one of the following:
"addedContactInfoList": {
object (ContactInfoList )
},
"addedMobileDeviceIdList": {
object (MobileDeviceIdList )
}
// End of list of possible types for union field added_members .
// Union field removed_members can be only one of the following:
"removedContactInfoList": {
object (ContactInfoList )
},
"removedMobileDeviceIdList": {
object (MobileDeviceIdList )
}
// End of list of possible types for union field removed_members .
} |
フィールド |
advertiserId |
string (int64 format)
必須。更新されたカスタマー マッチの FirstAndThirdPartyAudience のオーナー広告主の ID。
|
共用体フィールド added_members 。カスタマー マッチ オーディエンスに追加するメンバー。added_members は次のいずれかになります。 |
addedContactInfoList |
object (ContactInfoList )
入力のみの追加するメンバーを定義する連絡先情報のリスト。
|
addedMobileDeviceIdList |
object (MobileDeviceIdList )
入力のみの追加するメンバーを定義するモバイル デバイス ID のリスト。
|
共用体フィールド removed_members 。カスタマー マッチ オーディエンスから削除するメンバー。removed_members は次のいずれかになります。 |
removedContactInfoList |
object (ContactInfoList )
入力のみの削除するメンバーを定義する連絡先情報のリスト。
|
removedMobileDeviceIdList |
object (MobileDeviceIdList )
入力のみの削除するメンバーを定義するモバイル デバイス ID のリスト。
|
レスポンスの本文
FirstAndThirdPartyAudienceService.EditCustomerMatchMembers のレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
{
"firstAndThirdPartyAudienceId": string
} |
フィールド |
firstAndThirdPartyAudienceId |
string (int64 format)
必須。更新されたカスタマー マッチの FirstAndThirdPartyAudience の ID。
|
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eEdits the member list of a Customer Match audience, supporting \u003ccode\u003eCUSTOMER_MATCH_CONTACT_INFO\u003c/code\u003e and \u003ccode\u003eCUSTOMER_MATCH_DEVICE_ID\u003c/code\u003e audience types.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the \u003ccode\u003efirstAndThirdPartyAudienceId\u003c/code\u003e in the path and \u003ccode\u003eadvertiserId\u003c/code\u003e in the request body.\u003c/p\u003e\n"],["\u003cp\u003eAllows adding or removing members by providing contact information or mobile device IDs.\u003c/p\u003e\n"],["\u003cp\u003eReturns the \u003ccode\u003efirstAndThirdPartyAudienceId\u003c/code\u003e of the updated audience upon successful completion.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This API endpoint updates a Customer Match audience's member list via a `POST` request to a specific URL with the audience ID. The request requires an advertiser ID and allows adding or removing members through contact information or mobile device ID lists. The supported audience types are `CUSTOMER_MATCH_CONTACT_INFO` and `CUSTOMER_MATCH_DEVICE_ID`. The successful response returns the updated Customer Match audience ID, and OAuth scope `https://www.googleapis.com/auth/display-video` is necessary for authorization.\n"],null,["# Method: firstAndThirdPartyAudiences.editCustomerMatchMembers\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.EditCustomerMatchMembersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates the member list of a Customer Match audience.\n\nOnly supported for the following [audienceType](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.audience_type):\n\n- `CUSTOMER_MATCH_CONTACT_INFO`\n- `CUSTOMER_MATCH_DEVICE_ID`\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `firstAndThirdPartyAudienceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the Customer Match FirstAndThirdPartyAudience whose members will be edited. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"advertiserId\": string, // Union field `added_members` can be only one of the following: \"addedContactInfoList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList) }, \"addedMobileDeviceIdList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList) } // End of list of possible types for union field `added_members`. // Union field `removed_members` can be only one of the following: \"removedContactInfoList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList) }, \"removedMobileDeviceIdList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList) } // End of list of possible types for union field `removed_members`. } ``` |\n\n| Fields ||\n|-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the owner advertiser of the updated Customer Match FirstAndThirdPartyAudience. |\n| Union field `added_members`. The members to be added to the Customer Match audience. `added_members` can be only one of the following: ||\n| `addedContactInfoList` | `object (`[ContactInfoList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList)`)` Input only. A list of contact information to define the members to be added. |\n| `addedMobileDeviceIdList` | `object (`[MobileDeviceIdList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList)`)` Input only. A list of mobile device IDs to define the members to be added. |\n| Union field `removed_members`. The members to be removed from the Customer Match audience. `removed_members` can be only one of the following: ||\n| `removedContactInfoList` | `object (`[ContactInfoList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList)`)` Input only. A list of contact information to define the members to be removed. |\n| `removedMobileDeviceIdList` | `object (`[MobileDeviceIdList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList)`)` Input only. A list of mobile device IDs to define the members to be removed. |\n\n### Response body\n\nThe response of FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------|\n| ``` { \"firstAndThirdPartyAudienceId\": string } ``` |\n\n| Fields ||\n|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `firstAndThirdPartyAudienceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the updated Customer Match FirstAndThirdPartyAudience. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]