Chrome Management Chrome Browsers API

Interfejs Chrome Management Chrome Browsers API umożliwia administratorom wyświetlanie danych i zarządzanie przeglądarkami Chrome zarejestrowanymi w Chrome Enterprise Core. Ten zestaw interfejsów API może służyć do wyświetlania listy zarejestrowanych przeglądarek Chrome, pobierania przeglądarki Chrome, aktualizowania informacji o adnotacjach w przeglądarce Chrome, przenoszenia przeglądarek Chrome między jednostkami organizacyjnymi i usuwania danych zebranych z przeglądarki Chrome.

Krótkie omówienie metod interfejsu API

Adresy URL są powiązane z https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Opis Względny URL Metoda HTTP
Wyświetlanie listy zarejestrowanych przeglądarek Chrome /chromeBrowsers SPRAWDŹ
Pobieranie informacji o przeglądarce Chrome /chromeBrowsers/{browser_permanent_id} SPRAWDŹ
Aktualizowanie informacji o adnotacjach w przeglądarce Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Przenoszenie przeglądarek Chrome do nowej jednostki organizacyjnej /chromeBrowsers:move POST
Usuwanie danych zebranych z przeglądarki Chrome /chromeBrowsers/{browser_permanent_id} USUŃ

Przykładowe żądania i odpowiedzi znajdziesz w przykładowym kodzie.

Filtruję wyniki

Podczas wyświetlania listy przeglądarek Chrome za pomocą metody /chromeBrowsers możesz zawęzić wyniki, używając parametru zapytania filter. Wszystkie parametry filtra muszą być zakodowane w adresie URL, gdy są wysyłane w żądaniach HTTP. Wiele warunków można połączyć za pomocą operatora AND.

  • Pola typu String, Integer i Enum: obsługują operatory porównania = i :. Symbol wieloznaczny * (prefiks prefix*, sufiks *suffix, podłańcuch *substring* lub obecność *) jest obsługiwany z = i : tylko w przypadku machine_name, annotated_asset_id i browser_version (na przykład machine_name=LIX* lub browser_version:"*6367*"). Obsługiwane jest też filtrowanie ciągów znaków bez nazwy pola: pojedynczy termin, taki jak ABC, pasuje, jeśli dowolne indeksowane pole ciągu znaków zawiera ABC, a wiele terminów połączonych przez AND lub spację (na przykład machine AND 73 lub machine 73) pasuje do przeglądarek, które zawierają każdy określony termin w dowolnym z indeksowanych pól tekstowych (podczas gdy pojedynczy ciąg znaków składający się z wielu słów, taki jak "machine 73", pasuje do dokładnej frazy w jednym polu).
  • Pola sygnatur czasowych: obsługują operatory porównania =, <= i >=. Sygnatury czasowe oczekują ciągu znaków w formacie RFC-3339 ujętego w cudzysłów (np. "2020-01-01T12:00:00Z" lub "2012-04-21T11:30:00-04:00"). Zamknięte zakresy sygnatur czasowych można określić za pomocą porównań.
  • Filtrowanie według jednostki organizacyjnej: możesz filtrować przeglądarki należące do określonej jednostki organizacyjnej, podając org_unit_path (np. org_unit_path=/Marketing). Obsługiwane jest dopasowywanie pojedynczej jednostki organizacyjnej.
  • Filtrowanie grup: możesz filtrować przeglądarki należące do określonej grupy Cloud Identity za pomocą funkcji in_group (np. in_group("groups/00gjdgxs0lm8l7o")).

Pola, które można filtrować

Pole Opis
browser_permanent_id Stały unikalny identyfikator urządzenia z przeglądarką Chrome.
last_policy_fetch_time Czas ostatniego pobrania zasad na urządzeniu z przeglądarką Chrome.
os_platform Platforma systemu operacyjnego urządzenia z przeglądarką Chrome (np. WINDOWS, MAC, LINUX).
os_architecture Architektura systemu operacyjnego urządzenia z przeglądarką Chrome.
os_version Wersja systemu operacyjnego urządzenia z przeglądarką Chrome
machine_name Nazwa komputera powiązana z urządzeniem z przeglądarką Chrome.
annotated_location Oznaczona adnotacją lokalizacja urządzenia z przeglądarką Chrome.
annotated_user Oznaczony adnotacją użytkownik urządzenia z przeglądarką Chrome.
annotated_asset_id Oznaczony adnotacją identyfikator zasobu urządzenia z przeglądarką Chrome.
annotated_note Oznaczone adnotacją notatki dotyczące urządzenia z przeglądarką Chrome.
org_unit_path Ścieżka jednostki organizacyjnej urządzenia z przeglądarką Chrome (np. /Marketing).
org_unit_id Identyfikator jednostki organizacyjnej urządzenia z przeglądarką Chrome.
last_registration_time Czas rejestracji urządzenia z przeglądarką Chrome.
os_platform_version Platforma i wersja główna systemu operacyjnego urządzenia z przeglądarką Chrome.
browser_version Zgłoszona wersja przeglądarki Chrome zainstalowanej na urządzeniu.
last_status_report_time Czas ostatniego raportu o stanie urządzenia z przeglądarką Chrome.
extension_count Liczba rozszerzeń zainstalowanych na urządzeniu z przeglądarką Chrome.
policy_count Liczba zasad zastosowanych na urządzeniu z przeglądarką Chrome.
last_device_user ostatniego użytkownika zalogowanego na komputerze;
last_activity_time Czas ostatniej aktywności urządzenia z przeglądarką Chrome (pobranie lub zgłoszenie zasad).
device_id_collision Określa, czy identyfikator urządzenia jest wspólny dla wielu komputerów, które przeglądarka Chrome identyfikuje jako jedno urządzenie (true lub false).

Filtruj funkcje

Funkcja Opis
in_group(string) Filtruje listę urządzeń z przeglądarką Chrome, aby wyświetlić te, które należą do określonej nazwy zasobu grupy Cloud Identity (format: in_group("groups/{group_id}")).

Porządkowanie wyników

Kolejność wyników możesz określić za pomocą parametru zapytania orderBy. Domyślnie sortowanie odbywa się w kolejności rosnącej. Aby określić kolejność malejącą dla pola, dodaj sufiks " desc" do nazwy pola (np. last_activity_time desc).

Jeśli nie określono inaczej, domyślna kolejność sortowania to rosnąco według browser_permanent_id.

Obsługiwane pola porządkowania

  • 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

Uprawnienia administratora

Interfejs Chrome Browsers API uwzględnia przekazywanie ról administratora.

Metoda Wymagane uprawnienia administratora
ListChromeBrowsers „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki”
lub „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki -> Odczyt”
GetChromeBrowser „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki”
lub „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki -> Odczyt”
UpdateChromeBrowser „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki”
MoveChromeBrowsers „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki”
DeleteChromeBrowser „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki”

Aby zarządzać rolami i uprawnieniami administratora, otwórz „Konsola administracyjna -> Role administratora”.

Zakresy interfejsów API

Interfejs Chrome Management Chrome Browsers API wymaga tych zakresów OAuth:

Metoda Wymagane zakresy protokołu OAuth
ListChromeBrowsers thought https://www.googleapis.com/auth/chrome.management.browsers
lub https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser thought https://www.googleapis.com/auth/chrome.management.browsers
lub 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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.