Ressource: MobileDevice
Die Google Workspace-Mobilgeräteverwaltung umfasst Android-, Google Sync- und iOS-Geräte. Weitere Informationen zu häufigen API-Aufgaben für Gruppen-Mobilgeräte finden Sie im Entwicklerhandbuch.
JSON-Darstellung |
---|
{ "kind": string, "etag": string, "resourceId": string, "deviceId": string, "name": [ string ], "email": [ string ], "model": string, "os": string, "type": string, "status": string, "hardwareId": string, "firstSync": string, "lastSync": string, "userAgent": string, "serialNumber": string, "imei": string, "meid": string, "wifiMacAddress": string, "networkOperator": string, "defaultLanguage": string, "managedAccountIsOnOwnerProfile": boolean, "deviceCompromisedStatus": string, "buildNumber": string, "kernelVersion": string, "basebandVersion": string, "unknownSourcesStatus": boolean, "developerOptionsStatus": boolean, "otherAccountsInfo": [ string ], "adbStatus": boolean, "supportsWorkProfile": boolean, "manufacturer": string, "releaseVersion": string, "securityPatchLevel": string, "brand": string, "bootloaderVersion": string, "hardware": string, "encryptionStatus": string, "devicePasswordStatus": string, "privilege": string, "applications": [ { "packageName": string, "displayName": string, "versionName": string, "versionCode": integer, "permission": [ string ] } ] } |
Felder | |
---|---|
kind |
Der Typ der API-Ressource. Für Ressourcen von Mobilgeräten lautet der Wert |
etag |
Das ETag der Ressource. |
resourceId |
Die eindeutige ID, die der API-Dienst zur Identifizierung des Mobilgeräts verwendet. |
deviceId |
Die Seriennummer eines Mobilgeräts mit Google Sync. Bei Android- und iOS-Geräten ist dies eine softwaregenerierte eindeutige Kennung. |
name[] |
Die Liste der Nutzernamen des Eigentümers. Wenn Ihre App die aktuelle Liste der Geräteinhabernamen benötigt, verwenden Sie die get-Methode. Weitere Informationen zum Abrufen von Nutzerinformationen von Mobilgeräten finden Sie im Entwicklerhandbuch. |
email[] |
Die Liste der E-Mail-Adressen des Inhabers. Wenn die Anwendung die aktuelle Liste der Nutzer-E-Mail-Adressen benötigt, verwenden Sie die get-Methode. Weitere Informationen finden Sie unter Nutzer abrufen. |
model |
Den Modellnamen des Mobilgeräts, z. B. Nexus S. Dieses Attribut kann aktualisiert werden. Weitere Informationen finden Sie im Entwicklerhandbuch. |
os |
Das Betriebssystem des Mobilgeräts, z. B. iOS 4.3 oder Android 2.3.5. Dieses Attribut kann aktualisiert werden. Weitere Informationen finden Sie im Entwicklerhandbuch. |
type |
Der Typ des Mobilgeräts. |
status |
Der Status des Geräts. |
hardwareId |
Die eindeutige IMEI/MEID-Kennung für Android-Hardware. Sie gilt nicht für Google Sync-Geräte. Beim Hinzufügen eines Android-Mobilgeräts ist dies eine optionale Eigenschaft. Wenn Sie eines dieser Geräte aktualisieren, ist dies eine schreibgeschützte Eigenschaft. |
firstSync |
Datum und Uhrzeit, zu der das Gerät ursprünglich mit den Richtlinieneinstellungen in der Admin-Konsole synchronisiert wurde. Der Wert wird im ISO 8601-Datums- und Zeitformat angegeben. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
lastSync |
Datum und Uhrzeit der letzten Synchronisierung des Geräts mit den Richtlinieneinstellungen in der Admin-Konsole. Der Wert wird im ISO 8601-Datums- und Zeitformat angegeben. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
userAgent |
Liefert Informationen zum Gerät, z. B. die |
serialNumber |
Die Seriennummer des Geräts. |
imei |
Die IMEI-Nummer des Geräts. |
meid |
Die MEID-Nummer des Geräts. |
wifiMacAddress |
Die MAC-Adresse des Geräts in WLANs. |
networkOperator |
Mobilfunkanbieter oder Netzbetreiber des Mobilgeräts (falls verfügbar) (schreibgeschützt) |
defaultLanguage |
Die auf dem Gerät verwendete Standardsprache. |
managedAccountIsOnOwnerProfile |
Boolescher Wert, der angibt, ob sich dieses Konto im Inhaber-/Hauptprofil befindet. |
deviceCompromisedStatus |
Der Status des gehackten Geräts. |
buildNumber |
Build-Nummer des Betriebssystems des Geräts. |
kernelVersion |
Die Kernel-Version des Geräts. |
basebandVersion |
Die Baseband-Version des Geräts. |
unknownSourcesStatus |
Unbekannte Quellen auf dem Gerät aktiviert oder deaktiviert (schreibgeschützt) |
developerOptionsStatus |
Entwickleroptionen auf dem Gerät aktiviert oder deaktiviert (schreibgeschützt) |
otherAccountsInfo[] |
Die Liste der auf dem Gerät hinzugefügten Konten (schreibgeschützt) |
adbStatus |
ADB (USB-Debugging) auf Gerät aktiviert oder deaktiviert (schreibgeschützt) |
supportsWorkProfile |
Arbeitsprofil wird auf dem Gerät unterstützt (schreibgeschützt) |
manufacturer |
Hersteller des Mobilgeräts (schreibgeschützt) |
releaseVersion |
Release-Version des Mobilgeräts (schreibgeschützt) |
securityPatchLevel |
Sicherheitspatch-Level für Mobilgeräte (schreibgeschützt) |
brand |
Marke des Mobilgeräts (schreibgeschützt) |
bootloaderVersion |
Bootloader-Version des Mobilgeräts (schreibgeschützt) |
hardware |
Mobilgerät-Hardware (schreibgeschützt) |
encryptionStatus |
Verschlüsselungsstatus des Mobilgeräts (schreibgeschützt) |
devicePasswordStatus |
DevicePasswordStatus (schreibgeschützt) |
privilege |
DMAgentPermission (Lesezugriff) |
applications[] |
Die Liste der auf einem Android-Mobilgerät installierten Apps. Sie gilt nicht für Google Sync und iOS-Geräte. Die Liste enthält alle Android-Apps, die auf Google Workspace-Daten zugreifen. Beim Aktualisieren einer Anwendungsliste ist zu beachten, dass die vorhandene Liste durch Updates ersetzt wird. Wenn auf dem Android-Gerät zwei Anwendungen vorhanden sind und die API die Liste mit fünf Anwendungen aktualisiert, ist dies nun die aktualisierte Liste mit fünf Anwendungen.
|
applications[].packageName |
Der Paketname der Anwendung. Ein Beispiel dafür ist |
applications[].displayName |
Den Anzeigenamen der App. Ein Beispiel dafür ist |
applications[].versionName |
Der Versionsname der Anwendung. Ein Beispiel dafür ist |
applications[].versionCode |
Der Versionscode der Anwendung. Ein Beispiel dafür ist |
applications[].permission[] |
Die Liste der Berechtigungen dieser Anwendung. Dabei kann es sich entweder um eine standardmäßige Android-Berechtigung oder um eine von der App definierte Berechtigung handeln. Sie finden sie im Android-Manifest der App. Beispiele für die Berechtigungen einer Kalenderanwendung sind |
Methoden |
|
---|---|
|
eine Aktion durchführt, die ein Mobilgerät betrifft. |
|
Entfernt ein Mobilgerät. |
|
Ruft die Eigenschaften eines Mobilgeräts ab. |
|
Ruft eine paginierte Liste aller Mobilgeräte eines Nutzers für ein Konto ab. |