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 dafür, wie Sie Ihre Mobilgeräte auflisten, Details zu einem bestimmten Gerät abrufen sowie ein Gerät 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 werden die Platzhalter customerId und resourceId verwendet, um anzugeben, wo Sie diese IDs angeben würden. Die customerId kann mit der Methode Users.get abgerufen werden. Die 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 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?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 Antwortattributen 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 abrufen

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 Antwortattributen finden Sie in der API-Referenz.

JSON-Anfrage

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

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 Antwortattributen finden Sie in der API-Referenz.

JSON-Anfrage

Die folgende JSON-Anfrage zeigt ein Beispiel für eine Anfrage zum Genehmigen 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 Antwortattributen finden Sie in der API-Referenz.

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