REST Resource: mobiledevices

Ressource: MobileDevice

Die Google Workspace-Mobilgeräteverwaltung umfasst Android-, Google Sync- und iOS-Geräte. Weitere Informationen zu häufigen Aufgaben der Mobile Device API für Gruppen finden Sie im Entwicklerleitfaden.

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

ETag der Ressource.

resourceId

string

Die eindeutige ID, mit der der API-Dienst das Mobilgerät identifiziert.

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 Inhabers. 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 Ihre Anwendung die aktuelle Liste der E-Mail-Adressen von Nutzern benötigt, verwenden Sie die Methode get. Weitere Informationen finden Sie unter Nutzer abrufen.

model

string

Der Modellname des Mobilgeräts, z. B. Nexus S. Dieses Attribut kann aktualisiert werden. Weitere Informationen finden Sie im Entwicklerleitfaden.

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 Entwicklerleitfaden.

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 ein optionales Attribut. Bei der Aktualisierung eines dieser Geräte ist dies eine schreibgeschützte Eigenschaft.

firstSync

string

Datum und Uhrzeit, an dem das Gerät zum ersten Mal mit den Richtlinieneinstellungen in der Admin-Konsole synchronisiert wurde. Der Wert ist im Datums- und Zeitformat ISO 8601. Die Uhrzeit 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 ist im Datums- und Zeitformat ISO 8601. Die Uhrzeit 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

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

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

Mobilfunk- oder Netzwerkanbieter des Mobilgeräts (falls verfügbar) (schreibgeschützt)

defaultLanguage

string

Die Standardsprache des Geräts.

managedAccountIsOnOwnerProfile

boolean

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

deviceCompromisedStatus

string

Der 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 (Lesezugriff)

developerOptionsStatus

boolean

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

otherAccountsInfo[]

string

Liste der auf dem Gerät hinzugefügten Konten (schreibgeschützt)

adbStatus

boolean

Adb (USB-Debugging) auf dem Gerät aktiviert oder deaktiviert (Lesezugriff)

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)

Stand der Sicherheits-Patches 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 (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-Anwendungen, die auf Google Workspace-Daten zugreifen.

Beachten Sie beim Aktualisieren einer Anwendungsliste, dass die vorhandene Liste durch die Aktualisierung ersetzt wird. Wenn auf dem Android-Gerät zwei Apps vorhanden sind und die API die Liste mit fünf Apps aktualisiert, ist dies die aktualisierte Liste mit fünf Apps.

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. Dies kann eine standardmäßige Android-Berechtigung oder eine von der Anwendung definierte Berechtigung sein. Sie finden sie im Android-Manifest einer Anwendung. Beispiele für Berechtigungen einer Kalenderanwendung sind READ_CALENDAR oder MANAGE_ACCOUNTS.

Methoden

action

Eine Aktion wird ausgeführt, die sich auf ein Mobilgerät auswirkt.

delete

Entfernt ein Mobilgerät.

get

Ruft die Eigenschaften eines Mobilgeräts ab.

list

Ruft eine paginaierte Liste aller Mobilgeräte eines Nutzers für ein Konto ab.