Method: mobiledevices.list

Recupera un elenco paginato di tutti i dispositivi mobili di proprietà dell'utente per un account. Per recuperare un elenco che includa i dispositivi di proprietà dell'azienda, utilizza l'API Devices di Cloud Identity. Questo metodo ha un timeout di 60 minuti. Per ulteriori informazioni, vedi Risolvere i problemi relativi ai codici di errore.

Richiesta HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

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 massimo consentito è 100.
orderBy

enum (OrderBy)

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

string

Token per specificare la pagina successiva nell'elenco
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/workspace/admin/directory/v1/search-operators
sortOrder

enum (SortOrder)

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

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,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Il tipo di risorsa.
etag

string

ETag della risorsa.
mobiledevices[]

object (MobileDevice)

Un elenco di oggetti Dispositivo mobile.
nextPageToken

string

Token utilizzato per accedere alla pagina successiva di questo risultato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

OrderBy

Enum
DEVICE_ID Il numero di serie di un dispositivo mobile Google Sync. Per i dispositivi Android, si tratta di un identificatore univoco generato dal software.
EMAIL L'indirizzo email del proprietario del dispositivo.
LAST_SYNC Data e ora dell'ultima sincronizzazione delle impostazioni dei criteri del dispositivo.
MODEL Il modello del dispositivo mobile.
NAME Il nome utente del proprietario del dispositivo.
OS Il sistema operativo del dispositivo.
STATUS Lo stato del dispositivo.
TYPE Tipo di dispositivo.

Projection

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

SortOrder

Enum
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.