API Chrome Management Chrome Browsers

L'API Chrome Management Chrome Browsers consente agli amministratori di visualizzare i dati e gestire i browser Chrome registrati in Chrome Enterprise Core. Questo insieme di API può essere utilizzato per elencare i browser Chrome registrati, recuperare un browser Chrome, aggiornare le informazioni di annotazione per un browser Chrome, spostare i browser Chrome tra unità organizzative (UO) ed eliminare la raccolta dei dati da un browser Chrome.

Rapida panoramica dei metodi API

Gli URL sono relativi a https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Descrizione URL relativo Metodo HTTP
Elenca i browser Chrome registrati /chromeBrowsers GET
Recuperare un browser Chrome /chromeBrowsers/{browser_permanent_id} GET
Aggiorna le informazioni di annotazione per un browser Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Sposta i browser Chrome in una nuova unità organizzativa (UO) /chromeBrowsers:move POST
Elimina i dati raccolti da un browser Chrome /chromeBrowsers/{browser_permanent_id} ELIMINA

Consulta gli esempi di codice per richieste e risposte di esempio.

Filtro dei risultati in corso…

Quando elenchi i browser Chrome con il metodo /chromeBrowsers, puoi restringere i risultati utilizzando il parametro di query filter. Tutti i parametri di filtro devono essere sottoposti a escape dell'URL quando vengono inviati nelle richieste HTTP. Più condizioni possono essere combinate utilizzando l'operatore AND.

  • Campi di tipo Stringa, Intero ed Enum: Supporto= E: operatori di confronto. Il carattere jolly * (prefisso prefix*, suffisso *suffix, sottostringa *substring* o presenza *) è supportato con = e : solo per machine_name, annotated_asset_id e browser_version (ad esempio, machine_name=LIX* o browser_version:"*6367*"). È supportato anche il filtro di stringhe letterali globali senza attributi (senza un nome di campo): un singolo termine come ABC corrisponde se un campo di stringa indicizzato contiene ABC e più termini uniti da AND o spazi vuoti (ad esempio, machine AND 73 o machine 73) corrispondono ai browser che contengono ogni termine specificato in uno dei campi di testo indicizzati (mentre una singola stringa di più parole tra virgolette come "machine 73" corrisponde alla frase contigua esatta all'interno di un singolo campo).
  • Campi timestamp: supportano gli operatori di confronto =, <= e >=. I timestamp prevedono una stringa formattata RFC-3339 racchiusa tra virgolette doppie (ad esempio "2020-01-01T12:00:00Z" o "2012-04-21T11:30:00-04:00"). Gli intervalli di timestamp chiusi possono essere specificati utilizzando i confronti.
  • Filtro per unità organizzativa:puoi filtrare i browser appartenenti a un'unità organizzativa specifica specificando org_unit_path (ad esempio, org_unit_path=/Marketing). È supportata la corrispondenza di una singola unità organizzativa.
  • Filtro per gruppo:puoi filtrare i browser appartenenti a un gruppo Cloud Identity specifico utilizzando la funzione in_group (ad esempio, in_group("groups/00gjdgxs0lm8l7o")).

Campi filtrabili

Campo Descrizione
browser_permanent_id L'identificatore univoco permanente del dispositivo con browser Chrome.
last_policy_fetch_time La data e l'ora dell'ultimo recupero dei criteri per il dispositivo con browser Chrome.
os_platform La piattaforma del sistema operativo per il dispositivo con browser Chrome (ad es. WINDOWS, MAC, LINUX).
os_architecture L'architettura del sistema operativo del dispositivo con browser Chrome.
os_version La versione del sistema operativo per il dispositivo con browser Chrome
machine_name Il nome della macchina associata al dispositivo con browser Chrome.
annotated_location La posizione registrata per il dispositivo con browser Chrome.
annotated_user L'utente registrato per il dispositivo con browser Chrome.
annotated_asset_id L'ID asset registrato per il dispositivo con browser Chrome.
annotated_note Le note registrate per il dispositivo con browser Chrome.
org_unit_path Il percorso dell'unità organizzativa per il dispositivo con browser Chrome (ad es. /Marketing).
org_unit_id L'ID unità organizzativa per il dispositivo con browser Chrome.
last_registration_time La data e l'ora di registrazione del dispositivo con browser Chrome.
os_platform_version La piattaforma e la versione principale del sistema operativo per il dispositivo con browser Chrome.
browser_version Una versione del browser Chrome registrata installata sul dispositivo.
last_status_report_time L'ultimo report sullo stato generato per il dispositivo con browser Chrome.
extension_count Il numero di estensioni installate sul dispositivo con browser Chrome.
policy_count Il numero di policy applicate al dispositivo con browser Chrome.
last_device_user L'ultimo utente che ha eseguito l'accesso al computer.
last_activity_time L'ultima volta che è stata registrata un'attività sul dispositivo con browser Chrome (recupero dei criteri o generazione di report).
device_id_collision Indica se l'ID dispositivo è condiviso da più macchine che il browser Chrome identifica come una stessa macchina (true o false).

Funzioni di filtro

Funzione Descrizione
in_group(string) Filtra l'elenco dei dispositivi con browser Chrome in modo da includere solo quelli appartenenti al nome della risorsa del gruppo Cloud Identity specificato (formato: in_group("groups/{group_id}")).

Ordinamento dei risultati

Puoi specificare l'ordine dei risultati utilizzando il parametro di query orderBy. Per impostazione predefinita, l'ordinamento è in ordine crescente. Per specificare l'ordine decrescente per un campo, aggiungi il suffisso " desc" al nome del campo (ad esempio, last_activity_time desc).

Se non specificato, l'ordinamento predefinito è l'ordine crescente di browser_permanent_id.

Campi di ordinamento supportati

  • 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

Privilegi amministrativi

L'API Chrome Browsers rispetta la delega dei ruoli di amministratore.

Metodo Privilegi amministrativi richiesti
ListChromeBrowsers "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti"
o "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti -> Lettura"
GetChromeBrowser "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti"
o "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti -> Lettura"
UpdateChromeBrowser "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti"
MoveChromeBrowsers "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti"
DeleteChromeBrowser "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti"

Per gestire i ruoli e i privilegi di amministratore, vai a "Console di amministrazione -> Ruoli amministratore".

Ambiti API

L'API Chrome Management Chrome Browsers richiede i seguenti ambiti OAuth:

Metodo Ambiti OAuth richiesti
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
o https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
o 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

Per saperne di più, consulta la Panoramica dell'autenticazione.