Recupera un elenco impaginato di dispositivi ChromeOS all'interno di un account.
Richiesta HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias |
Parametri di query
Parametri | |
---|---|
maxResults |
Numero massimo di risultati da restituire. Il valore non deve superare 300. |
orderBy |
Proprietà del dispositivo da utilizzare per ordinare i risultati. |
orgUnitPath |
Il percorso completo dell'unità organizzativa (meno l'elemento |
pageToken |
Il parametro di query |
projection |
Determina se la risposta contiene l'elenco completo delle proprietà o solo un sottoinsieme. |
query |
Stringa di ricerca nel formato specificato all'indirizzo https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
La restituzione dei risultati in ordine crescente o decrescente. Deve essere utilizzato con il parametro |
includeChildOrgunits |
Restituisci i dispositivi di tutte le unità organizzative secondarie e dell'unità organizzativa specificata. Se è impostato su true, "orgUnitPath" è obbligatorio specificare un valore. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"kind": string,
"etag": string,
"chromeosdevices": [
{
object ( |
Campi | |
---|---|
kind |
Il tipo di risorsa. |
etag |
ETag della risorsa. |
chromeosdevices[] |
Un elenco di oggetti dei dispositivi ChromeOS. |
nextPageToken |
Token utilizzato per accedere alla pagina successiva di questo risultato. Per accedere alla pagina successiva, utilizza il valore di questo token nella stringa di query |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/admin.directory.device.chromeos
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
OrderBy
Enum | |
---|---|
ANNOTATED_LOCATION |
Posizione del dispositivo Chrome come annotato dall'amministratore. |
ANNOTATED_USER |
Utente di Chromebook come annotato dall'amministratore. |
LAST_SYNC |
La data e l'ora dell'ultima sincronizzazione del dispositivo Chrome con le impostazioni dei criteri nella Console di amministrazione. |
NOTES |
Note sul dispositivo Chrome come annotate dall'amministratore. |
SERIAL_NUMBER |
Il numero di serie del dispositivo Chrome inserito al momento dell'attivazione del dispositivo. |
STATUS |
Stato del dispositivo Chrome. Per ulteriori informazioni, visita la pagina relativa a <a chromeosdevices. |
Projection
Il tipo di proiezione da mostrare per i dispositivi.
Enum | |
---|---|
BASIC |
Include solo i campi dei metadati di base (ad es. deviceId, serialNumber, status e user) |
FULL |
Include tutti i campi dei metadati |
SortOrder
L'ordinamento da applicare all'elenco dei dispositivi.
Enum | |
---|---|
ASCENDING |
Ordine crescente. |
DESCENDING |
Ordine decrescente. |