自
2025 年 9 月 8 日起,每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 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
网址采用 gRPC 转码语法。
路径参数
参数 |
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 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\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)."]]