Method: exchanges.publishers.list

列出发布商。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。父级资源名称。示例：“exchanges/123”。

查询参数

参数
pageSize

integer

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

string

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

string

可选。允许按商品属性过滤。

支持的语法：

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

示例：

  • 获取状态设为“有效”的发布商 status=DISCOVERY_OBJECT_STATUS_ACTIVE

  • 获取显示名称为“display name”的订单 displayName="display name"

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

请求正文

请求正文必须为空。

响应正文

对列出发布商的请求做出的响应。

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

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

object (Publisher)

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

string

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

授权范围

需要以下 OAuth 范围：

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

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