החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
Method: firstPartyAndPartnerAudiences.editCustomerMatchMembers
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
עדכון רשימת החברים של קהל בהתאמה ללקוחות.
התכונה נתמכת רק ב-audienceType
הבאים:
CUSTOMER_MATCH_CONTACT_INFO
CUSTOMER_MATCH_DEVICE_ID
בקשת HTTP
POST https://displayvideo.googleapis.com/v4/firstPartyAndPartnerAudiences/{firstPartyAndPartnerAudienceId}:editCustomerMatchMembers
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
firstPartyAndPartnerAudienceId |
string (int64 format)
חובה. המזהה של הקהל מסוג 'התאמה ללקוחות: נתונים מאינטראקציה ישירה ונתונים משותפים' שרוצים לערוך את המשתתפים שלו.
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-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 המעודכן בהתאמה אישית לפי לקוחות.
|
שדה האיחוד added_members . החברים שרוצים להוסיף לקהל ההתאמה ללקוחות. הערך של added_members יכול להיות רק אחת מהאפשרויות הבאות: |
addedContactInfoList |
object (ContactInfoList )
קלט בלבד. רשימה של פרטי קשר כדי להגדיר את החברים שיתווספו.
|
addedMobileDeviceIdList |
object (MobileDeviceIdList )
קלט בלבד. רשימה של מזהי מכשירים ניידים כדי להגדיר את החברים שיתווספו.
|
שדה האיחוד removed_members . המשתתפים שרוצים להסיר מהקהל 'התאמה ללקוחות'. הערך של removed_members יכול להיות רק אחת מהאפשרויות הבאות: |
removedContactInfoList |
object (ContactInfoList )
קלט בלבד. רשימת פרטים ליצירת קשר כדי להגדיר את החברים שרוצים להסיר.
|
removedMobileDeviceIdList |
object (MobileDeviceIdList )
קלט בלבד. רשימה של מזהי מכשירים ניידים כדי להגדיר את החברים שרוצים להסיר.
|
גוף התשובה
התגובה של FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
{
"firstPartyAndPartnerAudienceId": string
} |
שדות |
firstPartyAndPartnerAudienceId |
string (int64 format)
חובה. המזהה של הקהל FirstPartyAndPartnerAudience המעודכן של התאמה ללקוחות.
|
היקפי הרשאה
נדרשת הרשאת OAuth ברמה הבאה:
https://www.googleapis.com/auth/display-video
מידע נוסף זמין בOAuth 2.0 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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)."]]