Kể từ
ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem
trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.
Method: firstPartyAndPartnerAudiences.editCustomerMatchMembers
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cập nhật danh sách thành viên của đối tượng So khớp khách hàng.
Chỉ hỗ trợ cho các audienceType sau:
CUSTOMER_MATCH_CONTACT_INFOCUSTOMER_MATCH_DEVICE_ID
Yêu cầu HTTP
POST https://displayvideo.googleapis.com/v4/firstPartyAndPartnerAudiences/{firstPartyAndPartnerAudienceId}:editCustomerMatchMembers
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
firstPartyAndPartnerAudienceId |
string (int64 format)
Bắt buộc. Mã của Đối tượng so khớp khách hàng FirstPartyAndPartnerAudience mà thành viên sẽ được chỉnh sửa.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng 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.
} |
| Trường |
advertiserId |
string (int64 format)
Bắt buộc. Mã của nhà quảng cáo sở hữu đối tượng FirstAndThirdPartyAudience trong chiến dịch Tìm khách hàng trùng khớp đã cập nhật.
|
Trường hợp hợp nhất added_members. Những thành viên sẽ được thêm vào đối tượng So khớp khách hàng. added_members chỉ có thể là một trong những loại sau: |
addedContactInfoList |
object (ContactInfoList)
Chỉ nhập. Danh sách thông tin liên hệ để xác định thành viên cần thêm.
|
addedMobileDeviceIdList |
object (MobileDeviceIdList)
Chỉ nhập. Danh sách mã thiết bị di động để xác định các thành viên cần thêm.
|
Trường hợp hợp nhất removed_members. Những thành viên sẽ bị xoá khỏi đối tượng So khớp khách hàng. removed_members chỉ có thể là một trong những loại sau: |
removedContactInfoList |
object (ContactInfoList)
Chỉ nhập. Danh sách thông tin liên hệ để xác định những thành viên cần xoá.
|
removedMobileDeviceIdList |
object (MobileDeviceIdList)
Chỉ nhập. Danh sách mã thiết bị di động để xác định các thành viên cần xoá.
|
Nội dung phản hồi
Phản hồi của FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"firstPartyAndPartnerAudienceId": string
} |
| Trường |
firstPartyAndPartnerAudienceId |
string (int64 format)
Bắt buộc. Mã của đối tượng FirstPartyAndPartnerAudience trong tính năng So khớp khách hàng đã cập nhật.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/display-video
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: firstPartyAndPartnerAudiences.editCustomerMatchMembers\n\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/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.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/v4/firstPartyAndPartnerAudiences/{firstPartyAndPartnerAudienceId}:editCustomerMatchMembers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `firstPartyAndPartnerAudienceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the Customer Match FirstPartyAndPartnerAudience 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/v4/firstPartyAndPartnerAudiences#ContactInfoList) }, \"addedMobileDeviceIdList\": { object (/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#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/v4/firstPartyAndPartnerAudiences#ContactInfoList) }, \"removedMobileDeviceIdList\": { object (/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#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/v4/firstPartyAndPartnerAudiences#ContactInfoList)`)` Input only. A list of contact information to define the members to be added. |\n| `addedMobileDeviceIdList` | `object (`[MobileDeviceIdList](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#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/v4/firstPartyAndPartnerAudiences#ContactInfoList)`)` Input only. A list of contact information to define the members to be removed. |\n| `removedMobileDeviceIdList` | `object (`[MobileDeviceIdList](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#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| ``` { \"firstPartyAndPartnerAudienceId\": string } ``` |\n\n| Fields ||\n|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `firstPartyAndPartnerAudienceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the updated Customer Match FirstPartyAndPartnerAudience. |\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)."]]
