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

有关详情，请参阅授权指南。