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

仅限输出。要返回的促销活动数量上限。服务返回的值可能小于此值。最大值为 1000；高于 1000 的值将被强制转换为 1000。如果未指定，将返回促销数量上限。
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 概览。