- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- AnnualSubscriptionInfo
- LicenseCounts
- PerpetualLicenseInfo
- 試してみる
指定された顧客のサブスクリプションとライセンスの集計情報をシングルトン リソースとして取得します。注: ChromeOS デバイスではデータがスナップショットされるため、正確な数値が最大 10 秒遅れることがあります。
HTTP リクエスト
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
name |
必須。取得する顧客の定期購入情報のリソース名。形式: customers/{customer}/subscriptionInfo |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
特定の顧客のサブスクリプションとライセンス情報を表すシングルトン リソース。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| フィールド | |
|---|---|
name |
ID。顧客のサブスクリプション情報のリソース名。形式: customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
出力専用。Chrome Enterprise Upgrade 年間 SKU の詳細。 |
kioskSignageUpgradeAnnual |
出力専用。Kiosk & Signage Upgrade 年間 SKU の詳細。 |
chromePerpetualUpgrade |
出力専用。Chrome Ent/Edu Upgrade Perpetual 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 |
出力専用。過去に登録されたが、その後、RMA、保証、修復などの理由で登録を解除された単体の永久アップグレードの数。同一モデルのデバイスでのみ再利用できます。条件付きで利用可能なライセンスの数は、割り当て済みライセンスの合計数に含まれます。 |