Method: customers.describeValidFrequencyLimitingEventMatchers

يسرد مُطابقات أحداث صالحة بالإضافة إلى بياناتها الوصفية لقوائم مستخدمي تحديد عدد مرات الظهور. تحتوي كل مطابقة حدث على بيانات وصفية تتضمّن، على سبيل المثال، AdsDataLink.Entity المالك واسمًا للحملة أو العنصر المقابل.

طلب HTTP

GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers

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

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

المَعلمات
customer

string

اسم مورد العميل، مثل 'customers/123'.

معامِلات طلب البحث

المَعلمات
adsDataCustomerId

string (int64 format)

بيانات أداء الإعلانات التي يملكها العميل (الرقم التعريفي للعميل)، مثل 456.
pageSize

integer

الحد الأقصى لعدد السلع التي يمكن إرجاعها. إذا لم يتم إدخال أي قيم، سيحدد الخادم عدد العملاء المرتبطين للعرض.
pageToken

string

الرمز المميز للصفحة، الذي يتم عرضه من خلال مكالمة سابقة، يُستخدم لطلب الصفحة التالية من النتائج، إن وجدت.
filter

string

حدِّد أدوات مطابقة الأحداث التي يتم عرضها. تقبل الفلاتر في كل الحقول الفرعية لكل event Matcher وeventMatcherMetadata.entity وeventMatcherMetadata.parent_event_matcher. أمثلة على الفلاتر: eventMatcher.value = 1234 eventMatcher.match_type = DV360_LINE_ITEM_ID OR eventMatcher.match_type = DV360_INSERTION_ORDER_ID eventMatcherMetadata.display_name = "Campaign 456&quot=event.parent_quot.Data_match.parent_match.entity_type.parent.match.entity.match.event.match.ثبت".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الرد على طلب DeDescriptionvalidUsageLimitingEventMatchersRequest.

تمثيل JSON 
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
الحقول
eventMatcherInfos[]

object (EventMatcherInfo)

قائمة الوحدات، يحتوي كل منها على مطابقة حدث مع بياناته الوصفية
nextPageToken

string

رمز مميز يمكن استخدامه لطلب صفحة النتائج التالية. ويكون هذا الحقل فارغًا في حال عدم توفّر نتائج إضافية.

نطاقات الأذونات

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

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

معلومات الحدث المتطابقة

مُطابق الحدث مع بياناته الوصفية.

تمثيل JSON 
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
الحقول
eventMatcher

object (EventMatcher)

مُطابق الحدث يحتوي على نوع القيد ومعرِّف صالح صالح.
eventMatcherMetadata

object (EventMatcherMetadata)

البيانات الوصفية لمُطابق الحدث

البيانات الوصفية لحدث Match Matcher

البيانات الوصفية لمُطابق الحدث

تمثيل JSON 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
الحقول
entity

object (Entity)

الكيان المرتبط من AdsDataLink.
displayName

string

الاسم في مخزن البيانات الأساسي للقيد. ويمكن أن يتمثل ذلك في اسم حملة أو اسم عنصر وما إلى ذلك.
parentEventMatcher

object (EventMatcher)

Event Matcher الرئيسي ذو الصلة، إن وجد. إذا كان event Matcher هو عنصر في "مساحة العرض والفيديو 360"، سيشير هذا الحقل إلى Event Matcher لطلب الإدراج المقابل على "مساحة العرض والفيديو 360" الذي يشكّل العنصر جزءًا منه.