Directory API: Mobilgeräte

Mit der Google Workspace Directory API können Sie Mobilgeräte in Ihrer Organisation verwalten. Auf dieser Seite finden Sie Beispiele dazu, wie Sie Ihre Mobilgeräte auflisten, Details zu einem bestimmten Gerät abrufen und Geräte hinzufügen oder entfernen.

In diesem Dokument wird davon ausgegangen, dass Sie die Voraussetzungen erfüllt haben. Auf Android-Geräten muss die Device Policy App installiert sein. iOS-Geräte müssen beim Google Mobile Management-Dienst registriert sein.

In diesen Beispielen geben die Platzhalter customerId und resourceId an, wo Sie diese IDs angeben würden. Der customerId kann über die Methode Users.get abgerufen werden. resourceId ist eine eindeutige Google-Kennung für ein Gerät und wird in der Antwort auf die Methode Alle Mobilgeräte abrufen zurückgegeben.

Alle Mobilgeräte abrufen

Wenn Sie alle Mobilgeräte eines Kontos abrufen möchten, verwenden Sie die folgende GET-Anfrage und fügen Sie die unter Anfragen autorisieren beschriebene Autorisierung ein. Zur besseren Lesbarkeit enthält dieses Beispiel Zeilenumbrüche: 

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

Informationen zu den Anfrage- und Antworteigenschaften finden Sie in der API-Referenz.

JSON-Antwort

{
   "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"
  }

Mobilgerät wiederherstellen

Wenn Sie die Eigenschaften eines Mobilgeräts abrufen möchten, verwenden Sie die folgende GET-Anfrage und fügen Sie die in Anfragen autorisieren beschriebene Autorisierung ein. Zur besseren Lesbarkeit enthält dieses Beispiel Zeilenumbrüche: 

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

Informationen zu den Anfrage- und Antworteigenschaften finden Sie in der API-Referenz.

JSON-Anfrage

Ein Beispiel für eine Anfrage für die resourceId: 

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

JSON-Antwort

{
   "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",
  }

Mobilgerät genehmigen

Wenn Sie ein Mobilgerät genehmigen möchten, verwenden Sie die folgende POST-Anfrage und fügen Sie die in Anfragen autorisieren beschriebene Autorisierung ein. Zur besseren Lesbarkeit enthält dieses Beispiel Zeilenumbrüche: 

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

Informationen zu den Anfrage- und Antworteigenschaften finden Sie in der API-Referenz.

JSON-Anfrage

Die folgende JSON-Anfrage ist ein Beispiel für die Genehmigung eines Geräts: 

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

Der Anfragetext lautet:

{
    "action": "approve"
}

Bei einer erfolgreichen Anfrage wird der HTTP-Statuscode 200 zurückgegeben.

Mobilgerät entfernen

Wenn Sie ein Mobilgerät entfernen möchten, verwenden Sie die folgende DELETE-Anfrage und fügen Sie die in Anfragen autorisieren beschriebene Autorisierung ein. Zur besseren Lesbarkeit enthält dieses Beispiel Zeilenumbrüche: 

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

Informationen zu den Anfrage- und Antworteigenschaften finden Sie in der API-Referenz.

Bei einer erfolgreichen Anfrage wird der HTTP-Statuscode 200 zurückgegeben.