Chrome Management Enrollment Tokens API

Interfejs Chrome Management Enrollment Tokens API umożliwia administratorom zarządzanie tokenami rejestracji używanymi do rejestrowania przeglądarek Chrome w Chrome Enterprise Core. Ten zestaw interfejsów API umożliwia tworzenie, pobieranie, wyświetlanie i unieważnianie tokenów rejestracji na urządzeniach.

Krótkie omówienie metod API

Adresy URL są względne względem https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Opis Względny URL Metoda HTTP
Tworzenie tokena rejestracji /enrollmentTokens POST
Pobieranie tokena rejestracji /enrollmentTokens/{token_permanent_id} SPRAWDŹ
Wyświetlanie listy tokenów rejestracji /enrollmentTokens SPRAWDŹ
Unieważnianie tokena rejestracji /enrollmentTokens/{token_permanent_id}:revoke POST

Przykładowe żądania i odpowiedzi znajdziesz w przykładowych fragmentach kodu.

Filtruję wyniki

Podczas wyświetlania tokenów rejestracji za pomocą metody /enrollmentTokens możesz zawęzić wyniki za pomocą parametru zapytania filter. Wszystkie parametry filtra muszą być kodowane w adresie URL podczas wysyłania w żądaniach HTTP. Wiele warunków można połączyć za pomocą operatora AND.

  • Pola tekstowe i wyliczeniowe: obsługują operatory porównania = i :.
  • Filtrowanie według jednostki organizacyjnej: możesz filtrować tokeny utworzone dla konkretnej jednostki organizacyjnej, określając org_unit_path lub org_unit_id.

Pola, które można filtrować

Pole Opis
device_type Typ urządzenia, na którym są używane tokeny rejestracji (obecnie CHROME_BROWSER).
token_state Stan tokena rejestracji (ACTIVE, EXPIRED, REVOKED).
org_unit_path Ścieżka jednostki organizacyjnej tokena rejestracji (np. /Marketing).
org_unit_id Zniekształcony identyfikator jednostki organizacyjnej dla tokena rejestracji.

Uprawnienia administratora

Interfejs Chrome Management Enrollment Tokens API uwzględnia delegowanie ról administratora.

Metoda Wymagane uprawnienia administratora
CreateEnrollmentToken „Usługi -> Zarządzanie urządzeniami z Chrome -> Ustawienia -> Zarządzane przeglądarki”
GetEnrollmentToken „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”
ListEnrollmentTokens „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”
RevokeEnrollmentToken „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 interfejsu API

Interfejs Chrome Management Enrollment Tokens API wymaga tych zakresów OAuth:

Metoda Wymagane zakresy protokołu OAuth
CreateEnrollmentToken https://www.googleapis.com/auth/chrome.management.enrollmenttokens
GetEnrollmentToken https://www.googleapis.com/auth/chrome.management.enrollmenttokens
lub https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly
ListEnrollmentTokens https://www.googleapis.com/auth/chrome.management.enrollmenttokens
lub https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly
RevokeEnrollmentToken https://www.googleapis.com/auth/chrome.management.enrollmenttokens

Więcej informacji znajdziesz w omówieniu uwierzytelniania.