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

ID。客戶訂閱資訊的資源名稱。格式:customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

僅供輸出。Chrome Enterprise 升級版年約 SKU 詳細資料。

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

僅供輸出。Kiosk & Signage 升級版年約 SKU 的詳細資料。

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

僅供輸出。Chrome Enterprise/Education 升級永久 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 正規化,並使用 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)

僅供輸出。先前曾註冊,但因退貨授權、保固或維修而取消註冊的獨立永久升級授權數,僅限重複用於相同型號的裝置。可視條件使用的授權包含在「已指派」授權內。