Method: exchanges.orders.products.list

列出商品。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

父级资源名称。示例：“exchanges/123/orders/456”。最多 250 个字符。必填。

查询参数

参数
pageSize

integer

需要返回的最大项数。 允许的最大值为 50。如果未指定或超过 50，则将使用 50 作为页面大小。
pageToken

string

从上一个 List 请求返回的 nextPageToken 值（如果有）。
filter

string

允许按商品属性过滤。

支持的语法：

  • 过滤条件表达式由一个或多个限制条件组成。
  • 限制条件可以通过 AND 或 OR 逻辑运算符组合使用。一系列限制会隐式使用 AND。
  • 限制的格式为 <field> <operator> <value>。
  • 运算符必须为 EQUALS (=)。
  • 支持的字段：
    • externalDealId

示例：

  • 获取在广告交易中外部交易 ID 设为“12345”的商品。externalDealId="12345"

将订单 ID 设置为“-”以对所有订单中的商品应用过滤条件。orders/-/products?filter=externalDealId="12345"

此字段的长度不得超过 500 个字符。

请求正文

请求正文必须为空。

响应正文

对列表顺序的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "products": [
    {
      object (Product)
    }
  ],
  "nextPageToken": string
}
字段
products[]

object (Product)

列出的商品。返回的项数将有一个上限，具体取决于请求中的 pageSize 字段。
nextPageToken

string

用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 Overview。