REST Resource: mobiledevices

Ressource: MobileDevice

Die Google Workspace-Mobilgeräteverwaltung umfasst Android-, Google Sync- und iOS-Geräte. Weitere Informationen zu gängigen API-Aufgaben für Gruppen von Mobilgeräten 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

string

Der Typ der API-Ressource. Für Mobilgeräteressourcen lautet der Wert admin#directory#mobiledevice.

etag

string

ETag der Ressource.

resourceId

string

Die eindeutige ID, die der API-Dienst zur Identifizierung des Mobilgeräts verwendet.

deviceId

string

Die Seriennummer eines Google Sync-Mobilgeräts. Bei Android- und iOS-Geräten ist dies eine softwaregenerierte eindeutige Kennung.

name[]

string

Die Liste der Nutzernamen des Eigentümers. Falls für Ihre App die aktuelle Liste der Geräteinhabernamen erforderlich ist, verwenden Sie die get-Methode. Weitere Informationen zum Abrufen von Nutzerinformationen zu Mobilgeräten finden Sie im Entwicklerhandbuch.

email[]

string

Die Liste der E-Mail-Adressen des Inhabers. Wenn Ihre Anwendung die aktuelle Liste der Nutzer-E-Mail-Adressen benötigt, verwenden Sie die get-Methode. Weitere Informationen finden Sie unter Nutzer abrufen.

model

string

Der Modellname des Mobilgeräts, z. B. „Nexus S“. Diese Property kann aktualisiert werden. Weitere Informationen finden Sie im Entwicklerhandbuch.

os

string

Das Betriebssystem des Mobilgeräts, z. B. iOS 4.3 oder Android 2.3.5. Diese Property kann aktualisiert werden. Weitere Informationen finden Sie im Entwicklerhandbuch.

type

string

Der Typ des Mobilgeräts.

status

string

Der Status des Geräts.

hardwareId

string

Die eindeutige IMEI/MEID-Kennung für die 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 diese Eigenschaft schreibgeschützt.

firstSync

string

Datum und Uhrzeit der ersten Synchronisierung des Geräts mit den Richtlinieneinstellungen in der Admin-Konsole. Der Wert liegt im ISO 8601-Format für Datum und Uhrzeit vor. Die Uhrzeit ist das vollständige Datum mit Stunden, Minuten und Sekunden im Format <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Beispiel: 2010-04-05T17:30:04+01:00

lastSync

string

Datum und Uhrzeit der letzten Synchronisierung des Geräts mit den Richtlinieneinstellungen in der Admin-Konsole. Der Wert liegt im ISO 8601-Format für Datum und Uhrzeit vor. Die Uhrzeit ist das vollständige Datum mit Stunden, Minuten und Sekunden im Format <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Beispiel: 2010-04-05T17:30:04+01:00

userAgent

string

Liefert Informationen zum Gerät, z. B. die os-Version. Diese Property kann aktualisiert werden. Weitere Informationen finden Sie im Entwicklerhandbuch.

serialNumber

string

Die Seriennummer des Geräts.

imei

string

Die IMEI-Nummer des Geräts

meid

string

Die MEID-Nummer des Geräts

wifiMacAddress

string

MAC-Adresse des Geräts in WLANs

networkOperator

string

Mobilfunkanbieter oder Netzbetreiber des Mobilgeräts (falls verfügbar) (schreibgeschützt)

defaultLanguage

string

Die auf dem Gerät verwendete Standardsprache.

managedAccountIsOnOwnerProfile

boolean

Boolescher Wert, der angibt, ob dieses Konto zum Inhaber/primären Profil gehört.

deviceCompromisedStatus

string

Status des manipulierten Geräts.

buildNumber

string

Die Build-Nummer des Betriebssystems des Geräts.

kernelVersion

string

Die Kernel-Version des Geräts.

basebandVersion

string

Die Baseband-Version des Geräts.

unknownSourcesStatus

boolean

Unbekannte Quellen auf dem Gerät aktiviert oder deaktiviert (schreibgeschützt)

developerOptionsStatus

boolean

Entwickleroptionen auf dem Gerät aktiviert oder deaktiviert (schreibgeschützt)

otherAccountsInfo[]

string

Die Liste der Konten, die auf dem Gerät hinzugefügt wurden (schreibgeschützt)

adbStatus

boolean

ADB (USB-Debugging) auf dem Gerät aktiviert oder deaktiviert (schreibgeschützt)

supportsWorkProfile

boolean

Arbeitsprofil wird auf Gerät unterstützt (schreibgeschützt)

manufacturer

string

Hersteller des Mobilgeräts (schreibgeschützt)

releaseVersion

string

Release-Version des Mobilgeräts (schreibgeschützt)

securityPatchLevel

string (int64 format)

Stand der Sicherheitsupdates für Mobilgeräte (schreibgeschützt)

brand

string

Marke des Mobilgeräts (schreibgeschützt)

bootloaderVersion

string

Bootloader-Version des Mobilgeräts (schreibgeschützt)

hardware

string

Hardware des Mobilgeräts (schreibgeschützt)

encryptionStatus

string

Verschlüsselungsstatus des Mobilgeräts (schreibgeschützt)

devicePasswordStatus

string

DevicePasswordStatus (schreibgeschützt)

privilege

string

DMAgentPermission (schreibgeschützt)

applications[]

object

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.

Beachten Sie beim Aktualisieren einer Anwendungsliste, 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 die Liste nun die aktualisierte Liste mit fünf Anwendungen.

applications[].packageName

string

Der Paketname der Anwendung. Ein Beispiel hierfür ist com.android.browser.

applications[].displayName

string

Der Anzeigename der Anwendung. Ein Beispiel hierfür ist Browser.

applications[].versionName

string

Der Versionsname der Anwendung. Ein Beispiel hierfür ist 3.2-140714.

applications[].versionCode

integer

Der Versionscode der Anwendung. Ein Beispiel hierfür ist 13.

applications[].permission[]

string

Die Liste der Berechtigungen für diese Anwendung. Dabei kann es sich entweder um eine standardmäßige Android-Berechtigung oder um eine von der App definierte Berechtigung handeln. Sie sind im Android-Manifest einer App zu finden. Beispiele für die Berechtigungen einer Kalenderanwendung sind READ_CALENDAR oder MANAGE_ACCOUNTS.

Methoden

action

eine Aktion ausführt, die ein Mobilgerät betrifft

delete

Entfernt ein Mobilgerät.

get

Ruft die Eigenschaften eines Mobilgeräts ab.

list

Ruft eine paginierte Liste aller Mobilgeräte des Nutzers eines Kontos ab.