Method: exchanges.publishers.list

列出發布商。

HTTP 要求

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/publishers

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

路徑參數

參數
parent

string

必要欄位。父項資源名稱。例如：「exchanges/123」。

查詢參數

參數
pageSize

integer

(非必要) 傳回的項目數量上限。允許的最大值為 50。如果未指定或超過 50，系統會使用 50 做為頁面大小。
pageToken

string

(非必要) 先前的 List 要求 (如果有的話) 傳回的 nextPageToken 值。
filter

string

(非必要) 允許依產品屬性篩選。

支援的語法：

  • 篩選器運算式由一或多個限制組成。
  • 限制條件可以透過 AND 或 OR 邏輯運算子結合。一系列限制會隱含使用 AND。
  • 限制的格式為 <field> <operator> <value>。
  • 運算子必須為 EQUALS (=)。
  • 支援的欄位：
    • ExternalPublisherId
    • DisplayName
    • Status

範例：

  • 取得狀態設為「有效」的發布商 status=DISCOVERY_OBJECT_STATUS_ACTIVE

  • 取得顯示名稱為「display name」的訂單 displayName="display name"

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

要求主體

要求主體必須為空白。

回應主體

回覆名單發布商。

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

JSON 表示法 
{
  "publishers": [
    {
      object (Publisher)
    }
  ],
  "nextPageToken": string
}
欄位
publishers[]

object (Publisher)

已列入名單的發布商。傳回的項目數量上限取決於要求中的 pageSize 欄位。
nextPageToken

string

用來擷取下一頁結果的符記；如果清單中沒有其他結果，這個欄位會是空白的。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。