Customer Subscriptions API を使用すると、管理者は特定の顧客のサブスクリプションとライセンスの集計情報を取得できます。
このサービスは、さまざまな ChromeOS ライセンス タイプにわたって、お客様レベルのサブスクリプションの詳細を取得します。
- Chrome Enterprise Upgrade(年間): 毎年更新される Chrome Enterprise Upgrade サブスクリプションに関する情報。購入済み、割り当て済み、未割り当てのライセンスの合計数、サブスクリプションの終了日などが表示されます。
- Kiosk & Signage Upgrade(年間): 毎年更新される Kiosk & Signage Upgrade サブスクリプションに関する情報(ライセンス数、サブスクリプションの終了日など)。
- Chrome Enterprise / Education Upgrade(永久): 永久ライセンスに関する情報。購入済み、割り当て済み、未割り当てのライセンスの合計数、廃止されたライセンス(廃止されたデバイスに登録されていたライセンスで、移行できないもの)、条件付きで利用可能なライセンス(RMA、保証、修理などの理由で登録解除されたスタンドアロンの永久アップグレードで、同じモデルのデバイスで再利用できるもの)が含まれます。
API メソッドの概要
URL は https://chromemanagement.googleapis.com/v1/customers/{customer_id} を基準とした相対 URL です。
| 説明 | 相対 URL | HTTP メソッド |
|---|---|---|
| お客様のサブスクリプションとライセンスの情報を取得する | /subscriptionInfo | GET |
リクエストとレスポンスの例については、コードサンプルをご覧ください。
管理者権限
Customer Subscriptions API は、管理者ロールの委任を尊重します。
| メソッド | 必要な管理者権限 |
|---|---|
| GetSubscriptionInfo | [サービス] -> [Chrome 管理] -> [ChromeOS デバイスの管理] > [ChromeOS デバイスの管理(読み取り専用)] または [サービス] -> [ChromeOS] -> [デバイス] -> [デバイスの管理] -> [読み取り] |
管理者ロールと権限を管理するには、[管理コンソール] > [管理者ロール] にアクセスしてください。
API スコープ
Chrome Management Customer Subscriptions API には、次の OAuth スコープが必要です。
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
詳細については、認証の概要をご覧ください。