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

允许按商品属性过滤。

支持的语法:

  • 过滤条件表达式由一个或多个限制条件组成。
  • 限制条件可以通过 ANDOR 逻辑运算符组合使用。一系列限制会隐式使用 AND
  • 限制的格式为 <field> <operator> <value>
  • status 和 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