以单例资源的形式获取给定客户的汇总订阅和许可信息。注意:由于 ChromeOS 设备的数据是快照数据,因此确切数字可能会延迟最多 10 秒。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
name |
必需。要检索的客户订阅信息的资源名称。格式:customers/{customer}/subscriptionInfo |
请求正文
请求正文必须为空。
响应正文
表示给定客户的订阅和许可信息的单例资源。
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| 字段 | |
|---|---|
name |
标识符。客户订阅信息的资源名称。格式:customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
仅限输出。Chrome 企业版升级(按年订阅)SKU 的详细信息。 |
kioskSignageUpgradeAnnual |
仅限输出。自助服务终端和标牌升级(按年订阅)SKU 的详细信息。 |
chromePerpetualUpgrade |
仅限输出。Chrome 企业版/教育版升级(永久)SKU 的详细信息。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
AnnualSubscriptionInfo
按年重复订阅/许可的相关信息。
| JSON 表示法 |
|---|
{
"counts": {
object ( |
| 字段 | |
|---|---|
counts |
仅限输出。此订阅的许可数量。 |
subscriptionEndTime |
仅限输出。当前订阅期结束的日期。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例: |
LicenseCounts
特定许可类型的资源数量。
| JSON 表示法 |
|---|
{ "totalPurchasedCount": string, "assignedCount": string, "unassignedCount": string } |
| 字段 | |
|---|---|
totalPurchasedCount |
仅限输出。已购买的许可总数。 |
assignedCount |
仅限输出。目前分配给用户或设备的许可总数。 |
unassignedCount |
仅限输出。可供分配的许可总数。 |
PerpetualLicenseInfo
永久许可的相关信息。
| JSON 表示法 |
|---|
{
"counts": {
object ( |
| 字段 | |
|---|---|
counts |
仅限输出。永久 SKU 的许可数量。 |
retiredCount |
仅限输出。已购买但无法再用于注册的永久升级许可数。这些许可是曾为设备注册过的永久升级许可,由于设备已弃用,这些许可已无法转移到其他设备或在其他设备上重复使用。已弃用的许可会计入已分配的许可总数。 |
conditionallyAvailableCount |
仅限输出。之前注册过,但后来因商品退货授权 (RMA)、保修或维修原因而取消注册的独立永久升级许可数,只能在型号相同的设备上再次使用。满足条件时可用的许可会计入已分配的许可总数。 |