اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
Method: firstPartyAndPartnerAudiences.editCustomerMatchMembers
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعديل قائمة أعضاء شريحة جمهور "مطابقة العملاء"
لا يمكن استخدامها إلا مع audienceType التالية:
CUSTOMER_MATCH_CONTACT_INFOCUSTOMER_MATCH_DEVICE_ID
طلب HTTP
POST https://displayvideo.googleapis.com/v4/firstPartyAndPartnerAudiences/{firstPartyAndPartnerAudienceId}:editCustomerMatchMembers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
firstPartyAndPartnerAudienceId |
string (int64 format)
مطلوب. رقم تعريف شريحة الجمهور FirstPartyAndPartnerAudience في ميزة "مطابقة العملاء" التي سيتم تعديل أعضائها.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل 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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)."]]
