Recupera un elenco impaginato 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 dei dispositivi di Cloud Identity. Questo metodo scade dopo 60 minuti. Per saperne di più, consulta l'articolo 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 ricerca
Parametri | |
---|---|
maxResults |
Numero massimo di risultati da restituire. Il valore massimo consentito è 100. |
orderBy |
Proprietà dispositivo da utilizzare per ordinare i risultati. |
pageToken |
Token per specificare la pagina successiva nell'elenco |
projection |
Limita le informazioni restituite a un insieme di campi selezionati. |
query |
Stringa di ricerca nel formato indicato all'indirizzo https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
Indica se restituire i 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 dei dispositivi mobili. |
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 alle autorizzazioni.
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 |
Include solo i campi dei metadati di base (ad es. deviceId, model, status, type e status) |
FULL |
Include tutti i campi di metadati |
SortOrder
Enum | |
---|---|
ASCENDING |
Ordine crescente. |
DESCENDING |
Ordine decrescente. |