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>。
  • 状态和显示名称的运算符必须为 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。