Recupera un elenco impaginato di tutti i dispositivi mobili di proprietà dell'utente per un account. Per recuperare un elenco che include dispositivi di proprietà dell'azienda, utilizza invece l'API Cloud Identity Devices. Questo metodo scade dopo 60 minuti. Per ulteriori informazioni, consulta la sezione Risolvere i problemi indicati dai 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 |
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 massimo consentito è 100. |
orderBy |
Proprietà del dispositivo da utilizzare per ordinare i risultati. |
pageToken |
Token per specificare la pagina successiva nell'elenco |
projection |
Consente di limitare le informazioni restituite a un insieme di campi selezionati. |
query |
Stringa di ricerca nel formato specificato all'indirizzo https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
La restituzione dei risultati in ordine crescente o decrescente. Deve essere utilizzato con il parametro |
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 ( |
Campi | |
---|---|
kind |
Il tipo di risorsa. |
etag |
ETag della risorsa. |
mobiledevices[] |
Un elenco di oggetti Mobile Device. |
nextPageToken |
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 da 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 |
Include 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. |