API Directory: dispositivi mobili

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": [
      "[email protected]"
     ],
     "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": [
      "[email protected]"
     ],
     "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": [
    "[email protected]"
   ],
   "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.