以單一資源的形式,取得特定客戶的匯總訂閱和授權資訊。注意:由於系統會為 ChromeOS 裝置建立資料快照,因此確切數字最多可能會延遲 10 秒。
HTTP 要求
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
name |
必填。要擷取的客戶訂閱資訊資源名稱。格式:customers/{customer}/subscriptionInfo |
要求主體
要求主體必須為空白。
回應主體
單例資源,代表特定客戶的訂閱和授權資訊。
如果成功,回應主體會含有以下結構的資料:
| JSON 表示法 |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| 欄位 | |
|---|---|
name |
ID。客戶訂閱資訊的資源名稱。格式:customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
僅供輸出。Chrome Enterprise 升級版年約 SKU 詳細資料。 |
kioskSignageUpgradeAnnual |
僅供輸出。Kiosk & Signage 升級版年約 SKU 的詳細資料。 |
chromePerpetualUpgrade |
僅供輸出。Chrome Enterprise/Education 升級永久 SKU 的詳細資料。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
AnnualSubscriptionInfo
年度週期性訂閱/授權的相關資訊。
| JSON 表示法 |
|---|
{
"counts": {
object ( |
| 欄位 | |
|---|---|
counts |
僅供輸出。這項訂閱方案的授權數量。 |
subscriptionEndTime |
僅供輸出。目前訂閱週期結束的日期。 使用 RFC 3339,產生的輸出內容一律會經過 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 |
僅供輸出。先前曾註冊,但因退貨授權、保固或維修而取消註冊的獨立永久升級授權數,僅限重複用於相同型號的裝置。可視條件使用的授權包含在「已指派」授權內。 |