Method: exchanges.orders.list

列出訂單。

HTTP 要求

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

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

路徑參數

參數
parent

string

父項資源名稱。例如：exchanges/123。必填。

查詢參數

參數
pageSize

integer

傳回的項目數量上限。預設值為 50。最大允許值為 200。如果未指定，則預設頁面大小為 50。如果 pageSize 大於 200，則頁面大小將使用 200。
pageToken

string

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

string

允許按訂單屬性進行篩選。

支援的語法：

  • 篩選運算式由一或多項限制組成。
  • 限制條件可透過 AND 或 OR 邏輯運算子合併。限制序列會隱含使用 AND。
  • 限制的形式為 <field> <operator> <value>。
  • 狀態和 displayName 的運算子必須為 EQUALS (=)。
  • 支援的欄位：
    • OrderStatus
    • DisplayName
    • UpdateTime

範例：

  • 取得狀態設為 ACCEPTED 的訂單 status=ACCEPTED

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

  • 取得更新時間晚於 2024-02-12T18:47:29.784Z updateTime>"2024-02-12T18:47:29.784Z" 的訂單

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

要求主體

要求主體必須為空白。

回應主體

列出訂單的回應。

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

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

object (Order)

列出的訂單。傳回的項目數量上限取決於要求中的 pageSize 欄位。
nextPageToken

string

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。