Method: inventorySourceGroups.list

列出目前使用者可存取的廣告空間來源群組。

順序由 orderBy 參數定義。

HTTP 要求

GET https://displayvideo.googleapis.com/v1/inventorySourceGroups

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

查詢參數

參數
pageSize

integer

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

string

識別伺服器應傳回結果的權杖。一般而言，這是從先前呼叫 ListInventorySources 方法傳回的 nextPageToken 值。如果未指定，系統會傳回第一頁的結果。
orderBy

string

排序清單的欄位。可接受的值如下：

  • displayName (預設)
  • inventorySourceGroupId

預設的排序順序為遞增。如要指定欄位的遞減順序，請在欄位名稱中加入字尾「desc」，例如 displayName desc。
filter

string

可依廣告空間來源群組欄位篩選。

支援的語法：

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

支援欄位：

  • inventorySourceGroupId

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

詳情請參閱篩選器 LIST 要求指南。
組合參數 accessor。必要欄位。用於辨識請求中的 DV360 實體。LIST 要求只會傳回可在 accessor 中識別的 DV360 實體可存取的廣告空間來源群組實體。accessor 只能是下列其中一個值：
partnerId

string (int64 format)

可存取廣告空間來源群組的合作夥伴 ID。

夥伴無法存取廣告客戶擁有的廣告空間來源群組。
advertiserId

string (int64 format)

可存取廣告空間來源群組的廣告客戶 ID。

如果廣告空間來源群組為合作夥伴自有，則只有明確共用群組的廣告客戶才能存取群組。

要求主體

要求主體必須為空白。

回應主體

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

InventorySourceGroupService.ListInventorySourceGroups 的回應訊息。

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

object (InventorySourceGroup)

廣告空間來源群組清單。

如果留空，這份清單就不會顯示。
nextPageToken

string

用於擷取下一頁結果的權杖。在後續呼叫 inventorySourceGroups.list 方法的 pageToken 欄位中，將這個值傳入，以擷取下一頁的結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。