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 esempi di richieste e risposte.
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. È possibile combinare più condizioni utilizzando l'operatore AND.
- Campi String, Integer ed Enum: supportano gli operatori di confronto
=e:. Il carattere jolly*(prefissoprefix*, suffisso*suffix, sottostringa*substring*o presenza*) è supportato con=e:solo permachine_name,annotated_asset_idebrowser_version(ad esempio,machine_name=LIX*obrowser_version:"*6367*"). È supportato anche il filtro di stringhe letterali globali semplici (senza un nome di campo): un singolo termine comeABCcorrisponde se un campo di stringa indicizzato contieneABCe più termini uniti daANDo spazi vuoti (ad esempio,machine AND 73omachine 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 (ad esempio,2020-01-01T12:00:00Zo"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 con una singola unità organizzativa. - Filtro dei gruppi: 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. |
virtual_device_id
|
L'ID dispositivo iniziale inviato dal primo browser Chrome che ha registrato questo dispositivo. |
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 risorsa 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 alla macchina. |
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 base a 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_idvirtual_device_idlast_policy_fetch_timeannotated_userannotated_locationannotated_asset_idannotated_notesorg_unit_pathos_versionlast_registration_timeextension_countpolicy_countlast_device_usermachine_namebrowser_version_channelos_platform_versionlast_activity_timebrowser_version
Privilegi amministrativi
L'API browser Chrome rispetta la delega dei ruoli di amministratore.
| Metodo | Sono richiesti privilegi amministrativi |
|---|---|
| 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.