Chrome Management Chrome Browsers API

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äfix prefix*, Suffix *suffix, Teilstring *substring* oder Vorhandensein *) wird mit = und : nur für machine_name, annotated_asset_id und browser_version unterstützt (z. B. machine_name=LIX* oder browser_version:"*6367*"). Die einfache Filterung nach globalen Stringliteralen (ohne Feldnamen) wird ebenfalls unterstützt: Ein einzelner Begriff wie ABC stimmt überein, wenn ein indexiertes Stringfeld ABC enthält. Mehrere Begriffe, die durch AND oder Leerzeichen verbunden sind (z. B. machine AND 73 oder machine 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:00Z oder "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_path angeben (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_group filtern (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_id
  • virtual_device_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_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.