Mit der Chrome Management Enrollment Tokens API können Administratoren Registrierungstokens verwalten, die zum Registrieren von Chrome-Browsern in Chrome Enterprise Core verwendet werden. Mit diesen APIs können Registrierungstokens für Geräte erstellt, abgerufen, aufgelistet und widerrufen werden.
Kurzübersicht über API-Methoden
URLs sind relativ zu
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Beschreibung | Relative URL | HTTP-Methode |
|---|---|---|
| Registrierungstoken erstellen | /enrollmentTokens | Posten |
| Registrierungstoken abrufen | /enrollmentTokens/{token_permanent_id} | NEUIGKEITEN |
| Registrierungstokens auflisten | /enrollmentTokens | NEUIGKEITEN |
| Registrierungstoken widerrufen | /enrollmentTokens/{token_permanent_id}:revoke | Posten |
Codebeispiele mit Beispielanfragen und ‑antworten
Ergebnisse werden gefiltert
Wenn Sie Registrierungstokens mit der Methode /enrollmentTokens auflisten, können Sie die Ergebnisse mit dem Abfrageparameter filter eingrenzen. Alle Filterparameter müssen URL-codiert werden, wenn sie in HTTP-Anfragen gesendet werden. Mehrere Bedingungen können mit dem Operator AND kombiniert werden.
- String- und Enum-Felder:Unterstützen die Vergleichsoperatoren
=und:. - Nach Organisationseinheit filtern:Sie können nach Tokens filtern, die für eine bestimmte Organisationseinheit erstellt wurden, indem Sie
org_unit_pathoderorg_unit_idangeben.
Filterbare Felder
| Feld | Beschreibung |
|---|---|
device_type
|
Der Gerätetyp, für den die Registrierungstokens verwendet werden (derzeit CHROME_BROWSER). |
token_state
|
Der Status des Registrierungstokens (ACTIVE, EXPIRED, REVOKED). |
org_unit_path
|
Der Pfad der Organisationseinheit für das Registrierungstoken (z.B. /Marketing). |
org_unit_id
|
Die verschleierte ID der Organisationseinheit für das Registrierungstoken. |
Administratorberechtigungen
Die Chrome Management Enrollment Tokens API berücksichtigt die Delegierung von Administratorrollen.
| Methode | Administratorberechtigungen erforderlich |
|---|---|
| CreateEnrollmentToken | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ |
| GetEnrollmentToken | „Dienste –> Chrome Management –> Einstellungen –> Verwaltete Browser“ oder „Dienste –> Chrome Management –> Einstellungen –> Verwaltete Browser –> Lesen“ |
| ListEnrollmentTokens | „Dienste –> Chrome Management –> Einstellungen –> Verwaltete Browser“ oder „Dienste –> Chrome Management –> Einstellungen –> Verwaltete Browser –> Lesen“ |
| RevokeEnrollmentToken | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ |
Wenn Sie Administratorrollen und ‑berechtigungen verwalten möchten, rufen Sie die Admin-Konsole auf und wählen Sie „Admin-Rollen“ aus.
können direkt einem Dienstkonto zugewiesen werden.API-Bereiche
Für die Chrome Management Enrollment Tokens API sind die folgenden OAuth-Bereiche erforderlich:
| Methode | Erforderliche OAuth-Bereiche |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens oder https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens oder https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
Weitere Informationen finden Sie in der Authentifizierungsübersicht.