API Directory: appareils mobiles

L'API Google Workspace Directory vous permet de gérer les appareils mobiles au sein de votre organisation. Cette page comprend des exemples illustrant la façon de répertorier vos appareils mobiles, d'obtenir des informations sur un appareil spécifique, ainsi que comme l'ajout ou la suppression d'un appareil.

Dans ce document, nous partons du principe que vous avez terminé Conditions préalables. Les appareils Android doivent disposer application Device Policy installés. Les appareils iOS doivent être enregistrés auprès du Service Gestion des appareils mobiles Google :

Dans ces exemples, les espaces réservés customerId et resourceId sont utilisés pour indiquez où vous devez fournir ces identifiants. Le customerId peut être obtenu à partir de Users.get. La resourceId est l'identifiant Google unique d'un appareil. Il figure dans la réponse de la méthode Récupérer tous les appareils mobiles.

Récupérer tous les appareils mobiles

Pour récupérer tous les appareils mobiles d'un compte, utilisez l'GET suivant demande et incluez l'autorisation décrite dans Autoriser les requêtes Pour une meilleure lisibilité, Cet exemple utilise des retours à la ligne: 

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

Pour les propriétés de requête et de réponse, consultez les Documentation de référence de l'API

Réponse 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"
  }

Récupérer un appareil mobile

Pour récupérer les propriétés d'un appareil mobile, utilisez la requête GET suivante. et incluez l'autorisation décrite dans Autoriser les requêtes Pour une meilleure lisibilité, Cet exemple utilise des retours à la ligne: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

Pour les propriétés de requête et de réponse, consultez les Documentation de référence de l'API

Requête JSON

Voici un exemple de requête pour resourceId: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

Réponse 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",
  }

Approuver un appareil mobile

Pour approuver un appareil mobile, utilisez la demande POST suivante et incluez les l'autorisation décrite dans Autoriser les requêtes Pour faciliter la lecture, cet exemple utilise des retours à la ligne: 

POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId/action

Pour les propriétés de requête et de réponse, consultez les Documentation de référence de l'API

Requête JSON

La requête JSON suivante présente un exemple de demande d'approbation d'un appareil: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices
  /mobile/resourceId/action

Le corps de la requête est le suivant :

{
    "action": "approve"
}

Si la requête aboutit, Code d'état HTTP 200 :

Supprimer un appareil mobile

Pour supprimer un appareil mobile, utilisez la requête DELETE suivante et incluez l'autorisation décrite dans Autoriser les requêtes Pour faciliter la lecture, cet exemple utilise des retours à la ligne: 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

Pour les propriétés de requête et de réponse, consultez les Documentation de référence de l'API

Si la requête aboutit, Code d'état HTTP 200 :