Method: subscriptions.list

由转销商管理的订阅列表。列表可以是所有订阅、客户的所有订阅，或客户的所有可转让订阅。

（可选）此方法可以按 customerNamePrefix 过滤响应。如需了解详情，请参阅管理订阅。

HTTP 请求

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

网址采用 gRPC 转码语法。

查询参数

参数
customerAuthToken

string

创建转销账号时，必须提供 customerAuthToken 查询字符串，以便将直销客户的订阅转移到您的转销商账号，或将其他转销商客户的订阅转移到您的转销商账号。这是完成订阅转移所需的十六进制身份验证令牌。如需了解详情，请访问管理员帮助中心。
customerId

string

这可以是客户的主域名，也可以是客户的唯一标识符。如果客户的域名发生变化，则无法使用旧域名访问该客户，但可以随时使用客户的唯一标识符（由 API 返回）。我们建议您在系统中存储唯一标识符（如果适用）。
customerNamePrefix

string

检索所有订阅并过滤出特定客户时，您可以输入客户名称的前缀。使用包含 exam.com、example20.com 和 example.com 的示例客户群组：

  • exa - 返回以“exa”开头的所有客户名称，其中可能包括 exam.com、example20.com 和 example.com。名称前缀类似于使用正则表达式的星号，例如 exa*。
  • example - 返回 example20.com 和 example.com。
maxResults

integer (uint32 format)

检索大型列表时，maxResults 是每页的结果数上限。nextPageToken 值会将您转到下一页。默认值为 20。
pageToken

string

用于指定列表中下一页的令牌

请求正文

请求正文必须为空。

响应正文

订阅用于管理 Google 客户的付款方案与产品的 SKU、用户许可、30 天免费试用状态和续订选项之间的关系。转销商的主要角色是管理 Google 客户的订阅。

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

JSON 表示法 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
字段
kind

string

将资源标识为订阅集合。值：reseller#subscriptions
subscriptions[]

object (Subscription)

此结果页中的订阅。
nextPageToken

string

用于对大型结果集进行分页的接续令牌。在后续请求中提供此值以返回下一页结果。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/apps.order.readonly

如需了解详情，请参阅授权指南。