Method: partners.inventorySources.list

列出廣告空間來源交易。

HTTP 要求

GET https://displayvideo.googleapis.com/v5/partners/{partnerId}/inventorySources

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

路徑參數

參數
必填。指出提出要求的 DV360 實體。LIST 要求只會傳回 accessor 中識別的 DV360 實體可存取的廣告空間來源實體。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
partnerId

string (int64 format)

DV360 合作夥伴 ID。
互斥欄位結束。

查詢參數

參數
pageSize

integer

(選用步驟) 要求的頁面大小。必須介於 1 至 200 之間。如未指定，則預設為 100。
pageToken

string

(選用步驟) 用來識別伺服器應傳回哪一頁結果的權杖。通常，這是先前呼叫 ListInventorySources 方法時傳回的 nextPageToken 值。如未指定，系統會傳回第一頁的結果。
orderBy

string

(選用步驟) 用於排序清單的欄位。可接受的值如下：

  • displayName (預設)

預設排列順序為遞增。如要指定欄位的遞減排序，請在欄位名稱後方加上「desc」。例如 displayName desc。
filter

string

(選用步驟) 可依廣告空間來源欄位篩選。

支援的語法：

  • 篩選運算式由一或多個限制組成。
  • 限制可透過 AND 或 OR 邏輯運算子合併。一連串的限制會隱含使用 AND。
  • 限制的格式為 {field} {operator} {value}。
  • 所有欄位都必須使用 EQUALS (=) 運算子。

支援的欄位：

  • status.entityStatus
  • commitment
  • deliveryMethod
  • rateDetails.rateType
  • exchange

範例：

  • 所有有效的廣告空間來源：status.entityStatus="ENTITY_STATUS_ACTIVE"
  • 屬於 Google Ad Manager 或 Rubicon 廣告交易平台的廣告空間來源：exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

這個欄位的長度不得超過 500 個字元。

詳情請參閱篩選 LIST 要求指南。
必填。指出提出要求的 DV360 實體。LIST 要求只會傳回 accessor 中識別的 DV360 實體可存取的廣告空間來源實體。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
advertiserId

string (int64 format)

DV360 廣告主 ID。
互斥欄位結束。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 ListInventorySourceDealsResponse 的執行個體。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/display-video

詳情請參閱OAuth 2.0 Overview。