Method: customers.userLists.addEventMatchers

لإضافة تطابقات الأحداث إلى قائمة مستخدمين تستند إلى معدل التكرار. لا يمكن أن تؤدي هذه المكالمة إلى حذف مُطابقات الأحداث الحالية أو تعديل البيانات الوصفية للقيود المستندة إلى معدّل التكرار، مثل النافذة أو عند إضافة مستخدم. قد تحتوي قائمة المستخدمين على بعض تطابقات الأحداث. على سبيل المثال، يمكن أن تؤدي هذه المكالمة إلى إضافة: AddEventMatchersRequest { userList: "customers/1/userLists/12345" eventMatchers { MatchType: GOOGLE_ADS_CAMPAIGN_ID value: "3456" } } لكي تنجح هذه المكالمة، يجب ألا تحتوي قائمة المستخدمين 12345 على قيود للحملة من النوع GOOGLE_ADS_campaign_ID &3; الحملة6&ID6الحملة_3؛

طلب HTTP

POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
userList

string

مطلوبة. يتضمّن اسم المورد الكامل صيغة "customers/[customerId]/userLists/[userlist_id]". ويجب أن تتضمّن قائمة المستخدمين UserUserType FREQUENCY_BASED.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "eventMatchers": [
    {
      object (EventMatcher)
    }
  ]
}
الحقول
eventMatchers[]

object (EventMatcher)

تحتوي هذه القيود فقط على الإضافة إلى قائمة المستخدمين. يجب ألا يكون لقائمة المستخدمين المحددة من قِبل userList أي من القيود المحددة هنا في وقت المكالمة، ولكن يمكن أن تحتوي على قيود أخرى حالية.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال UserList.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adsdatahub