Directory API: Mobilgeräte

Mit der Google Workspace Directory API können Sie Mobilgeräte in Ihrer Organisation verwalten. Diese Seite enthält Beispiele dafür, wie Sie Ihre Mobilgeräte auflisten, Details zu einem bestimmten Gerät abrufen und z. B. Geräte hinzufügen oder entfernen.

In diesem Dokument wird davon ausgegangen, dass Sie das Voraussetzungen. Android-Geräte benötigen die Device Policy App installiert haben. iOS-Geräte müssen bei der Google-Mobilgeräteverwaltung.

In diesen Beispielen werden die Platzhalter customerId und resourceId verwendet, um geben Sie an, wo Sie diese IDs angeben würden. Die customerId erhalten Sie auf der Users.get-Methode: Die resourceId ist eine eindeutige Google-Kennung für ein Gerät, die in der Antwort von die Methode Alle Mobilgeräte abrufen aus.

Alle Mobilgeräte abrufen

Wenn Sie alle Mobilgeräte eines Kontos abrufen möchten, verwenden Sie folgenden GET anfragen und die in den Anfragen autorisieren. Zur besseren Lesbarkeit In diesem Beispiel werden folgende Zeilen zurückgegeben: 

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

Verwenden Sie die folgende GET-Anfrage, um die Eigenschaften eines Mobilgeräts abzurufen. und enthalten die in den Anfragen autorisieren. Zur besseren Lesbarkeit In diesem Beispiel werden folgende Zeilen zurückgegeben: 

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

Hier ist eine Beispielanfrage für das 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äte genehmigen

Wenn Sie ein Mobilgerät genehmigen möchten, verwenden Sie die folgende POST-Anfrage und fügen Sie den Autorisierung gemäß den Anfragen autorisieren. Zur besseren Lesbarkeit werden in diesem Beispiel Zeilen zurückgegeben: 

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 eine Beispielanfrage zur Genehmigung eines Geräts: 

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

Der Anfragetext lautet:

{
    "action": "approve"
}

Eine erfolgreiche Anfrage gibt eine HTTP 200-Statuscode.

Mobilgerät entfernen

Wenn Sie ein Mobilgerät entfernen möchten, verwenden Sie die folgende DELETE-Anfrage und fügen Sie die im Dokument beschriebene Autorisierung Anfragen autorisieren. Zur besseren Lesbarkeit werden in diesem Beispiel Zeilen zurückgegeben: 

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

Eine erfolgreiche Anfrage gibt eine HTTP 200-Statuscode.