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 Geräte hinzufügen oder entfernen.
In diesem Dokument wird davon ausgegangen, dass Sie die Voraussetzungen erfolgreich abgeschlossen 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 wird durch die Platzhalter customerId und resourceId angegeben, wo Sie diese IDs angeben. Der customerId kann über die Methode Users.get abgerufen werden. Die resourceId ist eine eindeutige Google-Kennung für ein Gerät und ist in der Antwort der Methode Abrufen aller Mobilgeräte enthalten.
Alle Mobilgeräte abrufen
Wenn du alle Mobilgeräte eines Kontos abrufen möchtest, verwende die folgende GET-Anfrage und füge die unter Anfragen autorisieren beschriebene Autorisierung ein. Zur besseren Lesbarkeit werden in diesem Beispiel Zeilenumsätze verwendet:
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 zum Abrufen der Eigenschaften eines Mobilgeräts die folgende GET-Anfrage und fügen Sie die unter Anfragen autorisieren beschriebene Autorisierung ein. Zur besseren Lesbarkeit werden in diesem Beispiel Zeilenumsätze verwendet:
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
Eine Beispielanfrage für den resourceId lautet:
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
Verwenden Sie zum Genehmigen eines Mobilgeräts die folgende POST-Anfrage und fügen Sie die unter Anfragen autorisieren beschriebene Autorisierung ein.
Zur besseren Lesbarkeit werden in diesem Beispiel Zeilenumsätze verwendet:
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"
}
Bei einer erfolgreichen Anfrage wird der HTTP 200-Statuscode zurückgegeben.
Mobilgerät entfernen
Verwenden Sie zum Entfernen eines Mobilgeräts die folgende DELETE-Anfrage und fügen Sie die unter Anfragen autorisieren beschriebene Autorisierung ein.
Zur besseren Lesbarkeit werden in diesem Beispiel Zeilenumsätze verwendet:
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 200-Statuscode zurückgegeben.