L'API Google Workspace Directory ti consente di gestire i dispositivi mobili all'interno della tua organizzazione. Questa pagina include esempi di come elencare i dispositivi mobili, ottenere i dettagli di un dispositivo specifico, nonché come aggiunta o rimozione di un dispositivo.
Questo documento presuppone che tu abbia completato correttamente Prerequisiti. I dispositivi Android devono disporre app Device Policy installato. I dispositivi iOS devono essere registrati con Servizio Gestione dispositivi mobili Google.
In questi esempi, i segnaposto customerId e resourceId vengono utilizzati per indicare dove fornire questi ID. Puoi ottenere customerId Metodo Users.get. La resourceId è un identificatore Google univoco di un dispositivo e si trova nella risposta di il metodo Recupera tutti i dispositivi mobili.
Recupera tutti i dispositivi mobili
Per recuperare tutti i dispositivi mobili di un account, usa GET
richiedere e includere l'autorizzazione descritta in
Autorizzare le richieste. Per una migliore leggibilità,
in questo esempio vengono utilizzati i ritorni a capo:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile?projection={BASIC|FULL}&query=query &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING} &pageToken=token for next results page &maxResults=max number of results per page
Per le proprietà della richiesta e della risposta, consulta Riferimento API.
Risposta JSON
{ "kind": "directory#mobiledevices", "mobiledevices": [ { "kind": "directory#mobiledevice", "resourceId": "resourceId", "deviceId": "deviceId", "name": [ "Sales" ], "email": [ "sales@example.com" ], "model": "Nexus 4", "os": "Android 4.2.2", "type": "ANDROID", "status": "APPROVED", "hardwareId": "1234567890", "firstSync": "2013-05-15T17:30:04.325Z", "lastSync": "2013-06-05T17:30:04.325Z", "userAgent": "Google Apps Device Policy 4.14", }, { "kind": "directory#mobiledevice", "resourceId": "resourceId", "deviceId": "deviceId", "name": [ "Liz" ], "email": [ "liz@example.com" ], "model": "Galaxy Nexus", "os": "Android 4.2.2", "type": "ANDROID", "status": "APPROVED", "hardwareId": "9123456780", "firstSync": "2013-06-05T17:30:04.325Z", "lastSync": "2013-08-12T17:30:04.325Z", "userAgent": "Google Apps Device Policy 4.14", } ], "nextPageToken": "next_page_token_value" }
Recuperare un dispositivo mobile
Per recuperare le proprietà di un dispositivo mobile, utilizza la seguente richiesta GET
e includere l'autorizzazione descritta in
Autorizzare le richieste. Per una migliore leggibilità,
in questo esempio vengono utilizzati i ritorni a capo:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId?projection={FULL|BASIC}
Per le proprietà della richiesta e della risposta, consulta Riferimento API.
Richiesta JSON
Una richiesta di esempio per resourceId è:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ mobile/resourceId?projection=FULL
Risposta JSON
{ "kind": "directory#mobiledevice", "resourceId": "resourceId", "deviceId": "deviceId", "name": [ "Sales3" ], "email": [ "sales@example.com" ], "model": "Nexus 4", "os": "Android 4.2.2", "type": "ANDROID", "status": "APPROVED", "hardwareId": "1234567890", "firstSync": "2010-05-15T17:30:04.325Z", "lastSync": "2013-06-05T17:30:04.325Z", "userAgent": "Google Apps Device Policy 4.14", }
Approvare un dispositivo mobile
Per approvare un dispositivo mobile, usa la seguente richiesta di POST
e includi i campi
l'autorizzazione descritta in
Autorizzare le richieste.
Per la leggibilità, in questo esempio vengono utilizzati i ritorni a riga di comando:
POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId/action
Per le proprietà della richiesta e della risposta, consulta Riferimento API.
Richiesta JSON
La seguente richiesta JSON mostra una richiesta di esempio per approvare un dispositivo:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices /mobile/resourceId/action
Il corpo della richiesta è:
{ "action": "approve" }
Una richiesta andata a buon fine restituisce un Codice di stato HTTP 200.
Rimuovere un dispositivo mobile
Per rimuovere un dispositivo mobile, usa la seguente richiesta di DELETE
e includi
l'autorizzazione descritta in
Autorizzare le richieste.
Per la leggibilità, in questo esempio vengono utilizzati i ritorni a riga di comando:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId
Per le proprietà della richiesta e della risposta, consulta Riferimento API.
Una richiesta andata a buon fine restituisce un Codice di stato HTTP 200.