Method: guaranteedOrders.list

列出目前使用者可存取的保證訂單。

順序由 orderBy 參數定義。如果未指定 filter by entityStatus，結果就不會包含實體狀態為 ENTITY_STATUS_ARCHIVED 的保證訂單。

HTTP 要求

GET https://displayvideo.googleapis.com/v3/guaranteedOrders

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

查詢參數

參數
pageSize

integer

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

string

這個符記可識別伺服器應傳回的結果頁面。通常這是先前呼叫 guaranteedOrders.list 方法時傳回的 nextPageToken 值。如未指定，系統會傳回第一頁的結果。
orderBy

string

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

  • displayName (預設)

預設排序順序為遞增。如要針對欄位指定遞減順序，則應於欄位名稱後方加上「desc」，例如 displayName desc。
filter

string

允許依保證訂單欄位篩選。

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

支援的欄位：* guaranteedOrderId * exchange * displayName * status.entityStatus

範例：

  • 所有有效的保證訂單：status.entityStatus="ENTITY_STATUS_ACTIVE"
  • 屬於 Google Ad Manager 或 Rubicon 交易平台的保證訂單：exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

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

詳情請參閱篩選器 LIST 要求指南。

聯集參數 accessor。必填。

識別提出要求的 DV360 實體。LIST 要求只會傳回 accessor 中識別的 DV360 實體可存取的保證訂單實體。accessor 只能是下列其中一項：
partnerId

string (int64 format)

有權存取保證訂單的合作夥伴 ID。
advertiserId

string (int64 format)

有權存取保證訂單的廣告主 ID。

要求主體

要求主體必須為空白。

回應主體

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

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

object (GuaranteedOrder)

保證訂單清單。

如果沒有任何項目，系統就不會顯示這份清單。
nextPageToken

string

用來擷取下一頁結果的符記。在後續呼叫 guaranteedOrders.list 方法時，將這個值傳遞至 pageToken 欄位，即可擷取下一頁結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。