Method: customers.describeValidFrequencyLimitingEventMatchers

רשימת התאמות חוקיות של אירועים, יחד עם המטא-נתונים של רשימות קהלים למכסת תדירות. לכל התאמה של אירוע יש מטא-נתונים הכוללים, למשל, מאפיין AdsDataLink.Entity בבעלותו, ושם של הקמפיין או הפריט התואמים.

בקשת HTTP

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

כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.

פרמטרים של נתיב

פרמטרים
customer

string

שם המקור של הלקוח, למשל 'customers/123'.

פרמטרים של שאילתה

פרמטרים
adsDataCustomerId

string (int64 format)

מזהה הלקוח של בעלות על נתוני מודעות, למשל 456.
pageSize

integer

מספר הפריטים המקסימלי להחזרה. אם הערך הוא 0, השרת יקבע את מספר הלקוחות המקושרים שיחזרו.
pageToken

string

אסימון דף, שהוחזר על ידי שיחה קודמת, ששימש לבקשת דף התוצאות הבא, אם יש כזה.
filter

string

הגבלת ההתאמות של אירועים. מקבל מסננים בכל שדות המשנה של eventMATCHer, 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" eventMATCHerMetadata. ההכנסה. יומן_הסודה של_סוג_סוג_סוג_סוג_ המכשירים_סוג_ מזהי_סוג_דוגמאות.סוג_סוג_משתמשים_סוג_ אזור_סוג_דוגמאות_סוג_ מזהי_דוגמאות. אזור_ זמנית

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם התגובה מוצלחת, גוף התגובה מכיל נתונים במבנה הבא:

תגובה לבקשה ל-DescribevalidFrequencylimitingEventMATCHersRequest.

ייצוג 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)

מטא-נתונים של התאמת האירוע.

מטא-נתונים של EventMATCHer

מטא-נתונים של התאמת האירוע.

ייצוג JSON 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
שדות
entity

object (Entity)

ישות מקושרת מ-AdsDataLink.
displayName

string

השם של מאגר הנתונים הבסיסי של האילוץ. למשל: שם של קמפיין, שם של פריט וכו'.
parentEventMatcher

object (EventMatcher)

הורה תואם של האירוע, אם יש. אם EventEventer הוא פריט DV360, השדה הזה יתייחס ל-Event Matcher עבור סדר ההכנסה התואם של DV360 שאליו שייך הפריט.