Mit der Customer Subscriptions API können Administratoren aggregierte Abo- und Lizenzinformationen für einen bestimmten Kunden abrufen.
Dieser Dienst ruft Abodetails auf Kundenebene für verschiedene ChromeOS-Lizenztypen ab:
- Chrome Enterprise-Upgrade (jährlich): Informationen zu jährlich wiederkehrenden Chrome Enterprise-Upgrade-Abos, einschließlich der Gesamtzahl der gekauften, zugewiesenen und nicht zugewiesenen Lizenzen sowie des Enddatums des Abos.
- Upgrade für Kioske und Beschilderung (jährlich): Informationen zu jährlich wiederkehrenden Abos des Upgrades für Kioske und Beschilderung, einschließlich der Anzahl der Lizenzen und des Enddatums des Abos.
- Chrome Enterprise-/Education-Upgrade (unbefristet): Informationen zu unbefristeten Lizenzen, einschließlich der Gesamtzahl der gekauften, zugewiesenen und nicht zugewiesenen Lizenzen, der außer Betrieb genommenen Lizenzen (Lizenzen, die für ein Gerät registriert wurden, das inzwischen außer Betrieb genommen wurde und nicht übertragen werden kann) und der bedingt verfügbaren Lizenzen (eigenständige unbefristete Upgrades, die aus RMA-, Garantie- oder Reparaturgründen abgemeldet wurden und auf demselben Gerätemodell wiederverwendet werden können).
Kurze Übersicht über API-Methoden
URLs beziehen sich auf https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Beschreibung | Relative URL | HTTP-Methode |
|---|---|---|
| Informationen zu Kundenabos und ‑lizenzen abrufen | /subscriptionInfo | NEUIGKEITEN |
Beispielanfragen und -antworten finden Sie in den Codebeispielen.
Administratorberechtigungen
Die Customer Subscriptions API berücksichtigt die Delegierung von Administratorrollen.
| Methode | Administratorberechtigungen erforderlich |
|---|---|
| GetSubscriptionInfo | „Dienste -> Chrome-Verwaltung -> ChromeOS-Geräte verwalten > ChromeOS-Geräte verwalten (Lesezugriff)“ oder „Dienste -> ChromeOS -> Geräte -> Geräte verwalten -> Lesen“ |
Administratorrollen und ‑berechtigungen können Sie unter „Admin-Konsole“ -> „Admin-Rollen“ verwalten.
API-Bereiche
Für die Chrome Management Customer Subscriptions API ist der folgende OAuth-Bereich erforderlich:
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
Weitere Informationen finden Sie in der Authentifizierungsübersicht.