Method: customers.getSubscriptionInfo

以单例资源的形式获取给定客户的汇总订阅和许可信息。注意:由于 ChromeOS 设备的数据是快照数据,因此确切数字可能会延迟最多 10 秒。

HTTP 请求

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要检索的客户订阅信息的资源名称。格式:customers/{customer}/subscriptionInfo

请求正文

请求正文必须为空。

响应正文

表示给定客户的订阅和许可信息的单例资源。

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

JSON 表示法
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
字段
name

string

标识符。客户订阅信息的资源名称。格式:customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

仅限输出。Chrome 企业版升级(按年订阅)SKU 的详细信息。

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

仅限输出。自助服务终端和标牌升级(按年订阅)SKU 的详细信息。

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

仅限输出。Chrome 企业版/教育版升级(永久)SKU 的详细信息。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

AnnualSubscriptionInfo

按年重复订阅/许可的相关信息。

JSON 表示法
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
字段
counts

object (LicenseCounts)

仅限输出。此订阅的许可数量。

subscriptionEndTime

string (Timestamp format)

仅限输出。当前订阅期结束的日期。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

LicenseCounts

特定许可类型的资源数量。

JSON 表示法
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
字段
totalPurchasedCount

string (int64 format)

仅限输出。已购买的许可总数。

assignedCount

string (int64 format)

仅限输出。目前分配给用户或设备的许可总数。

unassignedCount

string (int64 format)

仅限输出。可供分配的许可总数。

PerpetualLicenseInfo

永久许可的相关信息。

JSON 表示法
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
字段
counts

object (LicenseCounts)

仅限输出。永久 SKU 的许可数量。

retiredCount

string (int64 format)

仅限输出。已购买但无法再用于注册的永久升级许可数。这些许可是曾为设备注册过的永久升级许可,由于设备已弃用,这些许可已无法转移到其他设备或在其他设备上重复使用。已弃用的许可会计入已分配的许可总数。

conditionallyAvailableCount

string (int64 format)

仅限输出。之前注册过,但后来因商品退货授权 (RMA)、保修或维修原因而取消注册的独立永久升级许可数,只能在型号相同的设备上再次使用。满足条件时可用的许可会计入已分配的许可总数。