资源:订阅
订阅的 JSON 模板。
JSON 表示法 |
---|
{ "customerId": string, "subscriptionId": string, "skuId": string, "creationTime": string, "kind": string, "seats": { object ( |
字段 | |
---|---|
customerId |
此属性将始终作为 Google 生成的唯一标识符在响应中返回。在请求中,此资源可以是主域名,也可以是 Google 生成的唯一标识符。 |
subscriptionId |
|
skuId |
必需的属性。 |
creationTime |
|
kind |
将资源标识为订阅。值: |
seats |
这是必需的属性。方案中的用户席位许可的数量和限制。 |
renewalSettings |
包年套餐承诺的续订设置。有关详情,请参阅管理员帮助中心中的续订选项。 |
purchaseOrderId |
这是一个可选属性。此采购订单 (PO) 信息供转销商用来跟踪其公司的使用情况。如果指定了 |
status |
这是一个可选属性。 |
resourceUiUrl |
指向管理控制台中“订阅”页面的网址。只读网址由 API 服务生成。如果您的客户端应用要求客户使用管理控制台中的“订阅”页面完成任务,系统就会使用此方法。 |
billingMethod |
只读字段,返回订阅的当前结算方式。 |
suspensionReasons[] |
只读字段,包含订阅的所有当前暂停原因的枚举。一个订阅可能会同时存在多个重叠的暂停原因。在解除所有待处理的暂停状态之前,订阅的
|
customerDomain |
客户的主域名 |
dealCode |
Google 针对订阅方案提供的折扣代码(上限为 100 个字符)。交易代码必须包含在 |
skuName |
订阅中的客户 SKU 的只读产品外部显示名称。SKU 名称由 Google 自行决定。如需了解此 API 版本中可用的产品和 SKU,请参阅产品和 SKU ID。 |
plan |
|
plan.planName |
|
plan.isCommitmentPlan |
|
plan.commitmentInterval |
在此版本的 API 中,年度方案的间隔为一年。 |
plan.commitmentInterval.startTime |
年度承诺方案的时间间隔,以毫秒为单位,使用 UNIX 纪元格式的毫秒数。 |
plan.commitmentInterval.endTime |
年度承诺计划的时间间隔(以毫秒为单位),使用 UNIX 纪元格式,以毫秒为单位。 |
trialSettings |
G Suite 包年和弹性付款方案可以免费试用 30 天。如需了解详情,请参阅 API 概念。 |
trialSettings.isInTrial |
确定订阅方案是否处于 30 天免费试用期内:
|
trialSettings.trialEndTime |
试用期结束的日期。该值以毫秒为单位,使用 UNIX 纪元格式。请参阅纪元转换器示例。 |
transferInfo |
订阅的只读转移相关信息。有关详情,请参阅为客户检索可转移的订阅。 |
transferInfo.transferabilityExpirationTime |
转移令牌或转移意图的时间。使用 UNIX 纪元格式的时间(以毫秒为单位)。 |
transferInfo.minimumTransferableSeats |
插入订阅时,这是此产品的转移订单中列出的最小席位数。例如,如果客户有 20 位用户,则转销商无法下达 15 个席位的转移订单。最少 20 个座位。 |
transferInfo.currentLegacySkuId |
当前转销的订阅的 |
座位数
订阅席位的 JSON 模板。
JSON 表示法 |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
字段 | |
---|---|
numberOfSeats |
这是必需属性,并且仅适用于订阅 |
maximumNumberOfSeats |
这是必需属性,并且仅适用于订阅 |
licensedNumberOfSeats |
只读字段,包含为 |
kind |
将资源标识为订阅席位设置。值: |
RenewalSettings
用于续订设置的 JSON 模板。
JSON 表示法 |
---|
{ "renewalType": string, "kind": string } |
字段 | |
---|---|
renewalType |
包年套餐承诺的续订设置。有关详情,请参阅管理员帮助中心中的续订选项。续订时, |
kind |
将资源标识为订阅续订设置。值: |
方法 |
|
---|---|
|
激活转销商之前暂停的订阅。 |
|
更新订阅方案。 |
|
更新用户许可的续订设置。 |
|
更新订阅的用户许可设置。 |
|
取消、暂停订阅或将订阅转移至直接订阅。 |
|
获取特定订阅。 |
|
创建或转移订阅。 |
|
由转销商管理的订阅列表。 |
|
立即将 30 天的免费试用期订阅改为付费服务订阅。 |
|
暂停有效订阅。 |