API Directory: appareils mobiles

L'API Directory de Google Workspace vous permet de gérer les appareils mobiles de votre organisation. Cette page inclut des exemples illustrant comment répertorier vos appareils mobiles, obtenir des informations sur un appareil spécifique et ajouter ou supprimer un appareil.

Dans ce document, nous partons du principe que vous avez rempli les conditions préalables. L'application de règles relatives aux appareils doit être installée sur les appareils Android et les appareils iOS doivent être enregistrés auprès du service Google Mobile Management.

Dans ces exemples, les espaces réservés customerId et resourceId sont utilisés pour indiquer où vous devez fournir ces ID. Vous pouvez obtenir le customerId à l'aide de la méthode Users.get. resourceId est un identifiant Google unique pour un appareil. Il se trouve dans la réponse de la méthode Retrieve all mobile devices (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 la requête GET suivante et incluez l'autorisation décrite dans la section 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 des requêtes et des réponses, consultez la 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": [
      "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"
  }

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 la section 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 des requêtes et des réponses, consultez la 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": [
    "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",
  }

Approuver un appareil mobile

Pour approuver un appareil mobile, utilisez la requête POST suivante et incluez l'autorisation décrite dans la section Autoriser les requêtes. Pour une meilleure lisibilité, 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 des requêtes et des réponses, consultez la documentation de référence de l'API.

Requête JSON

La requête JSON suivante présente un exemple de requête pour approuver 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"
}

Une requête réussie renvoie un 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 la section Autoriser les requêtes. Pour une meilleure lisibilité, 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 des requêtes et des réponses, consultez la documentation de référence de l'API.

Une requête réussie renvoie un code d'état HTTP 200.