Mit der Chrome Management Chrome Browsers API können Administratoren Daten einsehen und Chrome-Browser verwalten, die in Chrome Enterprise Core registriert sind. Mit diesen APIs können Sie registrierte Chrome-Browser auflisten, einen Chrome-Browser abrufen, Anmerkungsinformationen für einen Chrome-Browser aktualisieren, Chrome-Browser zwischen Organisationseinheiten verschieben und die von einem Chrome-Browser erhobenen Daten löschen.
Kurze Übersicht über API-Methoden
URLs beziehen sich auf https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Beschreibung | Relative URL | HTTP-Methode |
|---|---|---|
| Registrierte Chrome-Browser auflisten | /chromeBrowsers | NEUIGKEITEN |
| Chrome-Browser abrufen | /chromeBrowsers/{browser_permanent_id} | NEUIGKEITEN |
| Anmerkungsinformationen für einen Chrome-Browser aktualisieren | /chromeBrowsers/{browser_permanent_id} | PATCH |
| Chrome-Browser in eine neue Organisationseinheit verschieben | /chromeBrowsers:move | Posten |
| Über einen Chrome-Browser erhobene Daten löschen | /chromeBrowsers/{browser_permanent_id} | LÖSCHEN |
Beispielanfragen und -antworten finden Sie in den Codebeispielen.
Ergebnisse werden gefiltert
Wenn Sie Chrome-Browser mit der Methode /chromeBrowsers auflisten, können Sie die Ergebnisse mit dem Suchparameter filter eingrenzen. Alle Filterparameter müssen beim Senden in HTTP-Anfragen URL-codiert sein. Mehrere Bedingungen können mit dem Operator AND kombiniert werden.
- String-, Integer- und Enum-Felder: Unterstützen die Vergleichsoperatoren
=und:. Der Platzhalter*(Präfixprefix*, Suffix*suffix, Teilstring*substring*oder Vorhandensein*) wird mit=und:nur fürmachine_name,annotated_asset_idundbrowser_versionunterstützt (z. B.machine_name=LIX*oderbrowser_version:"*6367*"). Die einfache Filterung nach globalen Stringliteralen (ohne Feldnamen) wird ebenfalls unterstützt: Ein einzelner Begriff wieABCstimmt überein, wenn ein indexiertes StringfeldABCenthält. Mehrere Begriffe, die durchANDoder Leerzeichen verbunden sind (z. B.machine AND 73odermachine 73), stimmen mit Browsern überein, die jeden angegebenen Begriff in einem ihrer indexierten Textfelder enthalten. Ein einzelner String mit mehreren Wörtern in Anführungszeichen wie"machine 73"stimmt mit der genauen zusammenhängenden Wortgruppe in einem einzelnen Feld überein. - Zeitstempelfelder: Unterstützen die Vergleichsoperatoren
=,<=und>=. Zeitstempel erwarten einen RFC-3339-formatierten String (z. B.2020-01-01T12:00:00Zoder"2012-04-21T11:30:00-04:00"). Geschlossene Zeitstempelbereiche können mithilfe von Vergleichen angegeben werden. - Nach Organisationseinheit filtern: Sie können Browser filtern, die zu einer bestimmten Organisationseinheit gehören, indem Sie
org_unit_pathangeben (z. B.org_unit_path=/Marketing). Es wird nur eine Organisationseinheit unterstützt. - Gruppenfilterung: Sie können Browser, die zu einer bestimmten Cloud Identity-Gruppe gehören, mit der Funktion
in_groupfiltern (z. B.in_group("groups/00gjdgxs0lm8l7o")).
Filterbare Felder
| Feld | Beschreibung |
|---|---|
browser_permanent_id
|
Die dauerhafte eindeutige Kennung des Chrome-Geräts. |
virtual_device_id
|
Die ursprüngliche Geräte-ID, die vom ersten Chrome-Browser gesendet wurde, der dieses Gerät registriert hat. |
last_policy_fetch_time
|
Der Zeitpunkt des letzten Richtlinienabrufs für das Chrome-Gerät. |
os_platform
|
Die Betriebssystemplattform für das Chrome-Browser-Gerät (z.B. WINDOWS, MAC, LINUX). |
os_architecture
|
Die Betriebssystemarchitektur des Chrome-Browsers. |
os_version |
Die Betriebssystemversion des Chrome-Browser-Geräts. |
machine_name
|
Der Name des Computers, der mit dem Chrome-Browser-Gerät verknüpft ist. |
annotated_location
|
Der mit Anmerkungen versehene Standort für das Chrome-Browser-Gerät. |
annotated_user
|
Der annotierte Nutzer für den Chrome-Browser. |
annotated_asset_id
|
Die annotierte Asset-ID für das Chrome-Browser-Gerät. |
annotated_note
|
Die Anmerkungen für den Chrome-Browser. |
org_unit_path
|
Der Pfad der Organisationseinheit für das Chrome-Gerät (z.B. /Marketing). |
org_unit_id
|
Die ID der Organisationseinheit des Chrome-Geräts. |
last_registration_time
|
Die Registrierungszeit für das Chrome-Browser-Gerät. |
os_platform_version
|
Die Betriebssystemplattform und die Hauptversion des Chrome-Geräts. |
browser_version
|
Eine gemeldete Chrome-Browserversion, die auf dem Gerät installiert ist. |
last_status_report_time
|
Der letzte Statusbericht des Chrome-Geräts. |
extension_count
|
Die Anzahl der auf dem Chrome-Gerät installierten Erweiterungen. |
policy_count
|
Die Anzahl der Richtlinien, die auf das Chrome-Gerät angewendet werden. |
last_device_user |
Der zuletzt auf dem Gerät angemeldete Nutzer. |
last_activity_time
|
Die letzte Aktivität des Chrome-Browser-Geräts (Richtlinienabruf oder Berichterstellung). |
device_id_collision
|
Gibt an, ob die Geräte-ID von mehreren Computern gemeinsam genutzt wird, die der Chrome-Browser als dasselbe Gerät identifiziert (true oder false). |
Funktionen filtern
| Funktion | Beschreibung |
|---|---|
in_group(string)
|
Filtert die Liste der Chrome-Browsergeräte nach den Geräten, die zur angegebenen Cloud Identity-Gruppenressource gehören (Format: in_group("groups/{group_id}")). |
Ergebnisse sortieren
Mit dem Suchparameter orderBy können Sie die Reihenfolge der Ergebnisse festlegen. Standardmäßig wird in aufsteigender Reihenfolge sortiert. Wenn Sie absteigend sortieren möchten, fügen Sie dem Feldnamen das Suffix " desc" hinzu (z. B. last_activity_time
desc).
Wenn keine Angabe erfolgt, wird standardmäßig nach browser_permanent_id sortiert.
Unterstützte Sortierfelder
browser_permanent_idvirtual_device_idlast_policy_fetch_timeannotated_userannotated_locationannotated_asset_idannotated_notesorg_unit_pathos_versionlast_registration_timeextension_countpolicy_countlast_device_usermachine_namebrowser_version_channelos_platform_versionlast_activity_timebrowser_version
Administratorberechtigungen
Die Chrome Browsers API berücksichtigt die Delegierung von Administratorrollen.
| Methode | Administratorberechtigungen erforderlich |
|---|---|
| ListChromeBrowsers | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ oder „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser -> Lesen“ |
| GetChromeBrowser | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ oder „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser -> Lesen“ |
| UpdateChromeBrowser | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ |
| MoveChromeBrowsers | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ |
| DeleteChromeBrowser | „Dienste -> Chrome Management -> Einstellungen -> Verwaltete Browser“ |
Administratorrollen und -berechtigungen können Sie unter „Admin-Konsole -> Admin-Rollen“ verwalten.
API-Bereiche
Für die Chrome Management Chrome Browsers API sind die folgenden OAuth-Bereiche erforderlich:
| Methode | Erforderliche OAuth-Bereiche |
|---|---|
| ListChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers oder https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| GetChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers oder https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| UpdateChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
| MoveChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers |
| DeleteChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
Weitere Informationen finden Sie in der Authentifizierungsübersicht.