REST Resource: mobiledevices

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

string

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

etag

string

Das ETag der Ressource.

resourceId

string

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

deviceId

string

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

name[]

string

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[]

string

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

string

Den Modellnamen des Mobilgeräts, z. B. Nexus S. Dieses Attribut 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. Dieses Attribut 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 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

string

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 <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 wird im ISO 8601-Datums- und Zeitformat angegeben. Die Zeit ist das vollständige Datum plus 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. Dieses Attribut 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

Die 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 sich dieses Konto im Inhaber-/Hauptprofil befindet.

deviceCompromisedStatus

string

Der Status des gehackten Geräts.

buildNumber

string

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 auf dem Gerät hinzugefügten Konten (schreibgeschützt)

adbStatus

boolean

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

supportsWorkProfile

boolean

Arbeitsprofil wird auf dem 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)

Sicherheitspatch-Level 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

Mobilgerät-Hardware (schreibgeschützt)

encryptionStatus

string

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

devicePasswordStatus

string

DevicePasswordStatus (schreibgeschützt)

privilege

string

DMAgentPermission (Lesezugriff)

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.

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

string

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

applications[].displayName

string

Den Anzeigenamen der App. Ein Beispiel dafür ist Browser.

applications[].versionName

string

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

applications[].versionCode

integer

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

applications[].permission[]

string

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 READ_CALENDAR oder MANAGE_ACCOUNTS.

Methoden

action

eine Aktion durchfü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 eines Nutzers für ein Konto ab.