Method: chromeosdevices.list

Recupera un elenco paginato dei 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 il customerId del tuo account. customerId viene restituito anche all'interno della risorsa Utenti.

Parametri di query

Parametri
maxResults

integer

Il numero massimo di risultati da restituire. Il valore non deve superare 300.
orderBy

enum (OrderBy)

Proprietà del dispositivo da utilizzare per ordinare i risultati.
orgUnitPath

string

Il percorso completo dell'unità organizzativa (meno il carattere iniziale /) o il suo 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 tua risposta precedente.
projection

enum (Projection)

Determina se la risposta deve includere l'elenco completo delle proprietà o solo un sottoinsieme.
query

string

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

enum (SortOrder)

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

boolean

Restituisce i dispositivi di tutte le unità organizzative secondarie, nonché dell'unità organizzativa specificata. Se questo valore è impostato su true, è necessario fornire "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 Dispositivo 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 all'autorizzazione.

OrderBy

Enum
ANNOTATED_LOCATION La posizione del dispositivo Chrome in base a quanto annotato dall'amministratore.
ANNOTATED_USER Utente del Chromebook in base a quanto annotato dall'amministratore.
LAST_SYNC La data e l'ora in cui il dispositivo Chrome è stato sincronizzato l'ultima volta con le impostazioni dei criteri nella Console di amministrazione.
NOTES Note del dispositivo Chrome in base a quanto annotato 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, consulta <a chromeosdevices.

Projection

Il tipo di proiezione da mostrare per i dispositivi.

Enum
BASIC Sono inclusi solo i campi dei metadati di base (ad es. deviceId, serialNumber, status e user)
FULL Include tutti i campi dei metadati

SortOrder

L'ordine di ordinamento da applicare all'elenco di dispositivi.

Enum
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.