Method: customers.describeValidFrequencyLimitingEventMatchers

列出有效的事件比對器，以及用於展示頻率上限目標對象名單的中繼資料。每個事件比對器都有中繼資料，例如：擁有擁有的 DataDataLink.Entity，以及相應廣告活動或委刊項的名稱。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customer

string

客戶資源名稱，例如 'customers/123'.

查詢參數

參數
adsDataCustomerId

string (int64 format)

擁有廣告資料的客戶 ID，例如 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 = "CampaignMatch43 eventMatcherMetadata_entity_實體 quolereventDVer2.quoer;eventMatcher_er poserer_2 {/4}

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

對 ExplainValidfrequencyLimitingEventMatchersRequest 要求的回應。

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)

包含限制類型和有效限制 ID 的事件比對器。
eventMatcherMetadata

object (EventMatcherMetadata)

事件比對器的中繼資料。

EventMatcher 中繼資料

事件比對器的中繼資料。

JSON 表示法 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
欄位
entity

object (Entity)

已從 AdsDataLink 連結的實體。
displayName

string

限制的基礎資料儲存區名稱。例如廣告活動名稱、委刊項名稱等。
parentEventMatcher

object (EventMatcher)

相關的父項 EventMatcher (如果有的話)。如果 eventMatcher 是 DV360 委刊項，這個欄位會參照該委刊項所屬的 DV360 廣告訂單的 EventMatcher。