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 i customerId del tuo account. customerId viene restituito anche nell'ambito della risorsa Utenti.

Parametri di query

Parametri
maxResults

integer

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 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 è il nextPageToken della risposta precedente.

projection

enum (Projection)

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

query

string

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

sortOrder

enum (SortOrder)

La restituzione dei 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 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 (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 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.