Method: customers.getSubscriptionInfo

指定された顧客のサブスクリプションとライセンスの集計情報をシングルトン リソースとして取得します。注: ChromeOS デバイスではデータがスナップショットされるため、正確な数値が最大 10 秒遅れることがあります。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 Upgrade 年間 SKU の詳細。

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

出力専用。Kiosk & Signage Upgrade 年間 SKU の詳細。

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

出力専用。Chrome Ent/Edu Upgrade Perpetual 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)

出力専用。過去に登録されたが、その後、RMA、保証、修復などの理由で登録を解除された単体の永久アップグレードの数。同一モデルのデバイスでのみ再利用できます。条件付きで利用可能なライセンスの数は、割り当て済みライセンスの合計数に含まれます。