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

حداکثر تعداد اقلام برای بازگشت. اگر 0 باشد، سرور تعداد مشتریان لینک شده را برای بازگشت تعیین می کند.

pageToken

string

نشانه صفحه، که با تماس قبلی برگردانده شده است، برای درخواست صفحه بعدی نتایج، در صورت وجود، استفاده می شود.

filter

string

منطبق‌کننده‌های رویداد را محدود کنید. فیلترها را در تمام فیلدهای فرعی eventMatcher، eventMatcherMetadata.entity، و eventMatcherMetadata.parent_event_matcher می پذیرد. فیلترهای مثال: EventMatcher.Value = 1234 EventMatcher.Match_Type = DV360_LINE_ITEM_ID یا EVESTMATCHER.MATCH_TYPE = DV360_ORDISTION_INDISTACTATCHERMETADATA.DISTAMETADATA_NAME = "کمپین 456" GMP_DV360_ADVERTISER eventMatcherMetadata.parent_event_matcher.value = 6789 eventMatcherMetadata.parent_event_matcher.match_type = DV360_INSERTION_ORDER_ID

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پاسخ به یک درخواست DescribeValidFrequencyLimitingEventMatchersRequest.

نمایندگی JSON
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
زمینه های
eventMatcherInfos[]

object ( EventMatcherInfo )

فهرستی از واحدها که هر کدام شامل یک تطبیق رویداد به همراه ابرداده آن است

nextPageToken

string

نشانه ای که می تواند برای درخواست صفحه نتایج بعدی استفاده شود. در صورت عدم وجود نتایج اضافی، این فیلد خالی است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

EventMatcherInfo

تطبیق رویداد به همراه ابرداده آن.

نمایندگی JSON
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
زمینه های
eventMatcher

object ( EventMatcher )

تطبیق رویداد حاوی نوع محدودیت و شناسه محدودیت معتبر.

eventMatcherMetadata

object ( EventMatcherMetadata )

فراداده برای تطبیق رویداد.

EventMatcher Metadata

فراداده برای تطبیق رویداد.

نمایندگی JSON
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
زمینه های
entity

object ( Entity )

موجودیت مرتبط از AdsDataLink.

displayName

string

نام در ذخیره‌سازی داده زیربنایی برای محدودیت. این می تواند یک نام کمپین، نام مورد خط و غیره باشد.

parentEventMatcher

object ( EventMatcher )

EventMatcher والد مرتبط، در صورت وجود. اگر eventMatcher یک آیتم خط DV360 است، این قسمت به EventMatcher برای ترتیب درج DV360 مربوطه که مورد خط بخشی از آن است، ارجاع می‌دهد.