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
Vermerk 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 in HTTP-Anfragen mit URL-Escaping versehen werden. Mehrere Bedingungen können mit dem Operator AND kombiniert werden.

  • String-, Ganzzahl- 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 in doppelten Anführungszeichen (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.
last_policy_fetch_time Der letzte Richtlinienabruf des Chrome-Geräts.
os_platform Die Betriebssystemplattform des Chrome-Geräts (z.B. WINDOWS, MAC, LINUX).
os_architecture Die Betriebssystemarchitektur des Chrome-Geräts.
os_version Die Betriebssystemversion des Chrome-Geräts.
machine_name Der Name des Computers, der mit dem Chrome-Gerät verknüpft ist.
annotated_location Der festgelegte Standort des Chrome-Geräts.
annotated_user Der festgelegte Nutzer des Chrome-Geräts.
annotated_asset_id Die festgelegte Asset-ID des Chrome-Geräts.
annotated_note Die festgelegten Hinweise des Chrome-Geräts.
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 des Chrome-Geräts.
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-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-Browser-Geräte nach den Geräten, die zum angegebenen Ressourcennamen der Cloud Identity-Gruppe 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 in aufsteigender Reihenfolge sortiert.

Unterstützte Sortierfelder

  • browser_permanent_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“

Wenn Sie Administratorrollen und -berechtigungen verwalten möchten, rufen Sie „Admin-Konsole -> Admin-Rollen“ auf.

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.