Method: accounts.promotions.list

列出 Merchant Center 账号中的促销活动。响应中包含的项目数量可能少于 pageSize 指定的数量。依赖于 pageToken 来确定是否有更多要请求的项。

插入或更新促销活动后，可能需要几分钟才能检索到更新后的处理过的促销活动。

HTTP 请求

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出已处理的促销活动的账号。格式：accounts/{account}

查询参数

参数
pageSize

integer

仅限输出。要返回的促销活动的最大数量。服务返回的值可能小于此值。最大值为 250；大于 250 的值将被强制转换为 250。如果未指定，则会返回最大促销活动数量。
pageToken

string

仅限输出。从之前的 promotions.list 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 promotions.list 的所有其他参数必须与提供页面令牌的调用匹配。

请求正文

请求正文必须为空。

响应正文

promotions.list 方法的响应消息。

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

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

object (Promotion)

指定账号中已处理的促销活动。
nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

授权范围

需要以下 OAuth 范围：

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

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