Method: chromeosdevices.list

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

string

L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare le customerId del tuo account. customerId viene restituito anche come parte della risorsa Utenti.

Parametri di ricerca

Parametri
maxResults

integer

Numero massimo di risultati da restituire.
orderBy

enum (OrderBy)

Proprietà dispositivo da utilizzare per ordinare i risultati.
orgUnitPath

string

Il percorso completo dell'unità organizzativa (meno l'elemento / iniziale) o il relativo ID univoco.
pageToken

string

Il parametro di query pageToken viene utilizzato per richiedere la pagina successiva dei risultati della query. Il parametro di query pageToken della richiesta successiva è nextPageToken della risposta precedente.
projection

enum (Projection)

Limita le informazioni restituite a un insieme di campi selezionati.
query

string

Stringa di ricerca nel formato indicato all'indirizzo https://developers.google.com/admin-sdk/directory/v1/list-query-operators
sortOrder

enum (SortOrder)

Indica se restituire i risultati in ordine crescente o decrescente. Deve essere utilizzato con il parametro orderBy.
includeChildOrgunits

boolean

Restituisci i dispositivi di tutte le unità organizzative secondarie e l'unità organizzativa specificata. Se è impostato su true, è necessario specificare "orgUnitPath".

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 (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Il tipo di risorsa.
etag

string

ETag della risorsa.
chromeosdevices[]

object (ChromeOsDevice)

Un elenco di oggetti dei dispositivi ChromeOS.
nextPageToken

string

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 pageToken di questa richiesta.

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 alle autorizzazioni.

OrderBy

Enum
ANNOTATED_LOCATION Posizione del dispositivo Chrome annotata dall'amministratore.
ANNOTATED_USER Utente Chromebook 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 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 <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 di metadati

SortOrder

L'ordinamento da applicare all'elenco di dispositivi.

Enum
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.