REST Resource: enterprises.devices

Ressource: Gerät

Ein Gerät, das einem Unternehmen gehört. Sofern nicht anders angegeben, sind alle Felder schreibgeschützt und können von enterprises.devices.patch nicht geändert werden.

JSON-Darstellung 
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
Felder
name

string

Der Name des Geräts im Format enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

Der Ressourcenname des Nutzers, dem dieses Gerät gehört, im Format enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Der Verwaltungsmodus, den die Android Device Policy auf dem Gerät übernimmt. Das hat Einfluss darauf, welche Richtlinieneinstellungen unterstützt werden.
state

enum (DeviceState)

Der Status, der auf das Gerät angewendet werden soll. Dieses Feld kann durch eine Patchanfrage geändert werden. Beim Aufrufen von enterprises.devices.patch sind ACTIVE und DISABLED die einzigen zulässigen Werte. Um das Gerät in den Status DELETED zu versetzen, rufen Sie enterprises.devices.delete auf.
appliedState

enum (DeviceState)

Der aktuell auf das Gerät angewendete Status.
policyCompliant

boolean

Gibt an, ob das Gerät den Richtlinien entspricht.
nonComplianceDetails[]

object (NonComplianceDetail)

Details zu Richtlinieneinstellungen, mit denen das Gerät nicht konform ist.
enrollmentTime

string (Timestamp format)

Der Zeitpunkt der Geräteregistrierung.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

Das letzte Mal, dass das Gerät einen Statusbericht gesendet hat.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Veraltet.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Gerät die Richtlinie das letzte Mal abgerufen hat.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
policyName

string

Der Name der Richtlinie, die auf das Gerät angewendet wird, im Format enterprises/{enterpriseId}/policies/{policyId}. Wenn keine Angabe erfolgt, wird die policyName für den Nutzer des Geräts angewendet. Dieses Feld kann durch eine Patchanfrage geändert werden. Sie können beim Aufrufen von enterprises.devices.patch nur den policyId angeben, solange policyId keine Schrägstriche enthält. Der Rest des Richtliniennamens wird abgeleitet.
appliedPolicyName

string

Der Name der Richtlinie, die derzeit auf das Gerät angewendet wird.
appliedPolicyVersion

string (int64 format)

Die Version der Richtlinie, die derzeit auf das Gerät angewendet wird.
apiLevel

integer

Das API-Level der Version der Android-Plattform, die auf dem Gerät ausgeführt wird.
enrollmentTokenData

string

Wenn das Gerät mit einem Registrierungstoken und zusätzlich bereitgestellten Daten registriert wurde, enthält dieses Feld diese Daten.
enrollmentTokenName

string

Wenn das Gerät mit einem Registrierungstoken registriert wurde, enthält dieses Feld den Namen des Tokens.
disabledReason

object (UserFacingMessage)

Wenn der Gerätestatus „DISABLED“ lautet, wird eine optionale Meldung auf dem Gerät mit dem Grund für die Deaktivierung angegeben. Dieses Feld kann durch eine Patchanfrage geändert werden.
softwareInfo

object (SoftwareInfo)

Detaillierte Informationen zur Gerätesoftware. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „softwareInfoEnabled“ auf „true“ gesetzt ist.
hardwareInfo

object (HardwareInfo)

Detaillierte Informationen zur Gerätehardware.
displays[]

object (Display)

Detaillierte Informationen zu den Bildschirmen auf dem Gerät. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „displayInfoEnabled“ auf „true“ gesetzt ist.
applicationReports[]

object (ApplicationReport)

Berichte für Apps, die auf dem Gerät installiert sind. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „applicationReportsEnabled“ auf „true“ gesetzt ist.
previousDeviceNames[]

string

Wenn dasselbe Gerät mehrmals registriert wurde, enthält dieses Feld die Namen der vorherigen Geräte. Die Seriennummer wird als eindeutige Kennung verwendet, um festzustellen, ob dasselbe physische Gerät bereits registriert wurde. Die Namen werden in chronologischer Reihenfolge angegeben.
networkInfo

object (NetworkInfo)

Informationen zum Gerätenetzwerk. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „networkInfoEnabled“ auf „true“ gesetzt ist.
memoryInfo

object (MemoryInfo)

Arbeitsspeicherinformationen: enthält Informationen zum Arbeitsspeicher und Speicherplatz des Geräts.
memoryEvents[]

object (MemoryEvent)

Ereignisse im Zusammenhang mit Arbeitsspeicher- und Speichermesswerten in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „memoryInfoEnabled“ auf „true“ gesetzt ist.

Termine werden für einen bestimmten Zeitraum aufbewahrt und alte werden gelöscht.
powerManagementEvents[]

object (PowerManagementEvent)

Ereignisse zur Energieverwaltung auf dem Gerät in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „powerManagementEventsEnabled“ auf „true“ gesetzt ist.
hardwareStatusSamples[]

object (HardwareStatus)

Beispiele zum Hardwarestatus in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „hardwareStatusEnabled“ auf „true“ gesetzt ist.
deviceSettings

object (DeviceSettings)

Informationen zu den Geräteeinstellungen. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „deviceSettingsEnabled“ auf „true“ gesetzt ist.
user

object (User)

Der Nutzer, dem das Gerät gehört.
systemProperties

map (key: string, value: string)

Karte der ausgewählten Systemeigenschaften, die sich auf das Gerät beziehen. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „systemPropertiesEnabled“ auf „true“ gesetzt ist.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

Der Wert des Sicherheitsstatus des Geräts, der angibt, wie sicher das Gerät ist.
ownership

enum (Ownership)

Inhaberschaft des verwalteten Geräts
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informationen zum Common-Criteria-Modus – Sicherheitsstandards, die unter Common Criteria for Information Technology Security Evaluation (CC) definiert sind.

Diese Informationen sind nur verfügbar, wenn „statusReportingSettings.commonCriteriaModeEnabled“ in der Richtlinie des Geräts auf „true“ gesetzt ist.
appliedPasswordPolicies[]

object (PasswordRequirements)

Die Passwortanforderungen, die aktuell für das Gerät gelten.

  • Die angewandten Anforderungen können mitunter geringfügig von den in passwordPolicies angegebenen Anforderungen abweichen.
  • fieldPath basiert auf passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Nur Ausgabe Informationen darüber, ob dieses Gerät von der Verwaltung durch einen anderen Device Policy Controller (DPC) migriert wurde.

DeviceState

Status, die auf ein Gerät angewendet werden können.

Enums
DEVICE_STATE_UNSPECIFIED Dieser Wert ist nicht zulässig.
ACTIVE Das Gerät ist aktiv.
DISABLED Das Gerät ist deaktiviert.
DELETED Das Gerät wurde gelöscht. Dieser Status wird von einem API-Aufruf nie zurückgegeben, aber im endgültigen Statusbericht verwendet, wenn das Gerät das Löschen bestätigt. Wenn das Gerät über den API-Aufruf gelöscht wird, wird dieser Status in Pub/Sub veröffentlicht. Wenn der Nutzer das Arbeitsprofil löscht oder das Gerät zurücksetzt, bleibt der Gerätestatus dem Server unbekannt.
PROVISIONING Das Gerät wird bereitgestellt. Neu registrierte Geräte haben diesen Status, bis auf sie eine Richtlinie angewendet wird.
LOST Das Gerät ist verloren gegangen. Dieser Status ist nur auf organisationseigenen Geräten möglich.
PREPARING_FOR_MIGRATION Das Gerät wird auf die Migration zur Android Management API vorbereitet. Es sind keine weiteren Maßnahmen erforderlich, damit die Migration fortgesetzt werden kann.

NonComplianceDetail

Liefert Details zu Verstößen gegen eine Richtlinieneinstellung.

JSON-Darstellung 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Felder
settingName

string

Der Name der Richtlinieneinstellung. Dies ist der JSON-Feldname eines Policy-Felds auf oberster Ebene.
nonComplianceReason

enum (NonComplianceReason)

Der Grund, warum das Gerät die Einstellung nicht erfüllt.
packageName

string

Der Paketname, der angibt, welche App gegen die Nutzungsbedingungen verstößt, sofern zutreffend.
fieldPath

string

Wenn bei Einstellungen mit verschachtelten Feldern ein bestimmtes verschachteltes Feld nicht konform ist, wird hier der vollständige Pfad zum entsprechenden Feld angegeben. Der Pfad wird genauso formatiert wie das Richtlinien-JSON-Feld in JavaScript referenziert werden, d. h.: 1) Bei objekttypisierten Feldern folgt auf den Feldnamen ein Punkt und dann der Name des Unterfelds. 2) Bei Array-Feldern folgt auf den Feldnamen der Arrayindex in Klammern. Um beispielsweise auf ein Problem mit dem Feld url im Feld externalData der dritten Anwendung hinzuweisen, lautet der Pfad applications[2].externalData.url
currentValue

value (Value format)

Wenn die Richtlinieneinstellung nicht angewendet werden konnte, der aktuelle Wert der Einstellung auf dem Gerät.
installationFailureReason

enum (InstallationFailureReason)

Wenn packageName festgelegt ist und der Grund für die Nicht-Compliance APP_NOT_INSTALLED oder APP_NOT_UPDATED ist, ist eine detaillierte Begründung dafür enthalten, dass die App nicht installiert oder aktualisiert werden kann.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Der richtlinienspezifische Grund, warum das Gerät die Einstellung nicht erfüllt.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Zusätzlicher Kontext für specificNonComplianceReason.

InstallationFailureReason

Gründe, warum die Installation einer App möglicherweise fehlschlägt.

Enums
INSTALLATION_FAILURE_REASON_UNSPECIFIED Dieser Wert ist nicht zulässig.
INSTALLATION_FAILURE_REASON_UNKNOWN Ein unbekannter Zustand verhindert die Installation der App. Mögliche Gründe sind, dass auf dem Gerät nicht genügend Speicherplatz vorhanden ist, die Netzwerkverbindung des Geräts unzuverlässig ist oder die Installation länger als erwartet dauert. Die Installation wird automatisch wiederholt.
IN_PROGRESS Die Installation ist noch nicht abgeschlossen.
NOT_FOUND Die App wurde nicht in Google Play gefunden.
NOT_COMPATIBLE_WITH_DEVICE Die App ist nicht mit dem Gerät kompatibel.
NOT_APPROVED Die App wurde nicht vom Administrator genehmigt.
PERMISSIONS_NOT_ACCEPTED Die App hat neue Berechtigungen, die vom Administrator noch nicht akzeptiert wurden.
NOT_AVAILABLE_IN_COUNTRY Die App ist für das Land des Nutzers nicht verfügbar.
NO_LICENSES_REMAINING Es sind keine Lizenzen verfügbar, die dem Nutzer zugewiesen werden können.
NOT_ENROLLED Das Unternehmen ist nicht mehr bei Managed Google Play registriert oder der Administrator hat die aktuellen Nutzungsbedingungen von Managed Google Play nicht akzeptiert.
USER_INVALID Der Nutzer ist nicht mehr gültig. Der Nutzer wurde möglicherweise gelöscht oder deaktiviert.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Ein Netzwerkfehler auf dem Gerät des Nutzers hat die Installation verhindert. Das passiert normalerweise, wenn die Internetverbindung des Geräts beeinträchtigt ist oder nicht verfügbar ist oder wenn ein Problem bei der Netzwerkkonfiguration vorliegt. Achten Sie darauf, dass das Gerät Zugriff auf die volle Internetverbindung in einem Netzwerk hat, das Android Enterprise Network Requirements entspricht. Die Installation oder Aktualisierung der App wird in diesem Fall automatisch fortgesetzt.
INSUFFICIENT_STORAGE Auf dem Gerät des Nutzers ist nicht genügend Speicherplatz vorhanden, um die App zu installieren. Sie können das Problem beheben, indem Sie Speicherplatz auf dem Gerät freigeben. Die Installation oder Aktualisierung der App wird automatisch fortgesetzt, sobald auf dem Gerät genügend Speicherplatz vorhanden ist.

SpecificNonComplianceReason

Weitere Informationen dazu, warum ein Gerät einer Richtlinieneinstellung möglicherweise nicht entspricht. Der Enum können in Zukunft neue Werte hinzugefügt werden.

Enums
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Es ist kein genauer Grund für die Nicht-Konformität angegeben. Felder in specificNonComplianceContext sind nicht festgelegt.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Der Nutzer muss die Anmeldedaten durch Eingabe der Displaysperre bestätigen. Felder in specificNonComplianceContext sind nicht festgelegt. nonComplianceReason ist auf USER_ACTION gesetzt.
PASSWORD_POLICIES_PASSWORD_EXPIRED Das Geräte- oder Profilpasswort ist abgelaufen. passwordPoliciesContext ist festgelegt. nonComplianceReason ist auf USER_ACTION gesetzt.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Das Gerätepasswort entspricht nicht den Passwortanforderungen. passwordPoliciesContext ist festgelegt. nonComplianceReason ist auf USER_ACTION gesetzt.
ONC_WIFI_INVALID_VALUE In der ONC-WLAN-Konfiguration ist ein falscher Wert. fieldPath gibt an, welcher Feldwert falsch ist. oncWifiContext ist festgelegt. nonComplianceReason ist auf INVALID_VALUE gesetzt.
ONC_WIFI_API_LEVEL Die ONC-WLAN-Einstellung wird auf dem API-Level der Android-Version, die auf dem Gerät ausgeführt wird, nicht unterstützt. fieldPath gibt an, welcher Feldwert nicht unterstützt wird. oncWifiContext ist festgelegt. nonComplianceReason ist auf API_LEVEL gesetzt.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Im Unternehmens-WLAN fehlt entweder die Stammzertifizierungsstelle oder der Domainname. nonComplianceReason ist auf INVALID_VALUE gesetzt.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK Der Nutzer muss das konfigurierte WLAN manuell entfernen. Dies gilt nur für Arbeitsprofile auf privaten Geräten. nonComplianceReason ist auf USER_ACTION gesetzt.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY Der im Feld ClientCertKeyPairAlias in openNetworkConfiguration angegebene Schlüsselpaar-Alias entspricht keinem vorhandenen Schlüssel, der auf dem Gerät installiert ist. nonComplianceReason ist auf INVALID_VALUE gesetzt.

SpecificNonComplianceContext

Zusätzlicher Kontext für SpecificNonComplianceReason.

JSON-Darstellung 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Felder
oncWifiContext

object (OncWifiContext)

Zusätzlicher Kontext bei Nichteinhaltung der WLAN-Konfiguration. Siehe ONC_WIFI_INVALID_VALUE und ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Zusätzlicher Kontext bei Nichteinhaltung der Passwortrichtlinien. Weitere Informationen findest du unter PASSWORD_POLICIES_PASSWORD_EXPIRED und PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Zusätzlicher Kontext bei Nichteinhaltung der WLAN-Konfiguration.

JSON-Darstellung 
{
  "wifiGuid": string
}
Felder
wifiGuid

string

Die GUID der nicht konformen WLAN-Konfiguration.

PasswordPoliciesContext

Zusätzlicher Kontext bei Nichteinhaltung der Passwortrichtlinien.

JSON-Darstellung 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Felder
passwordPolicyScope

enum (PasswordPolicyScope)

Umfang des nicht konformen Passworts.

SoftwareInfo

Informationen zur Gerätesoftware.

JSON-Darstellung 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Felder
androidVersion

string

Der für den Nutzer sichtbare String der Android-Version. Beispiel: 6.0.1.
androidDevicePolicyVersionCode

integer

Der Versionscode der Android Device Policy App
androidDevicePolicyVersionName

string

Die Version der Android Device Policy App, wie sie dem Nutzer angezeigt wird.
androidBuildNumber

string

Android-Build-ID-String, der dem Nutzer angezeigt werden soll. Beispiel: shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Kernel-Version, z. B. 2.6.32.9-g103d848.
bootloaderVersion

string

Die Versionsnummer des System-Bootloaders, z.B. 0.6.7.
androidBuildTime

string (Timestamp format)

Build-Zeit.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
securityPatchLevel

string

Stand der Sicherheitsupdates, z.B. 2016-05-01.
primaryLanguageCode

string

Ein IETF-BCP-47-Sprachcode für die primäre Sprache auf dem Gerät.
deviceBuildSignature

string

SHA-256-Hash von android.content.pm.Signature, der dem Systempaket zugeordnet ist. Er kann verwendet werden, um zu prüfen, ob der System-Build geändert wurde.
systemUpdateInfo

object (SystemUpdateInfo)

Informationen zu einem möglicherweise ausstehenden Systemupdate.

SystemUpdateInfo

Informationen zu einem möglicherweise ausstehenden Systemupdate.

JSON-Darstellung 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Felder
updateStatus

enum (UpdateStatus)

Der Status einer Aktualisierung: Gibt an, ob eine Aktualisierung existiert und um welche Art von Update es sich handelt.
updateReceivedTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Update zum ersten Mal verfügbar war. Ein Nullwert bedeutet, dass dieses Feld nicht festgelegt ist. Dieses Feld wird nur festgelegt, wenn ein Update verfügbar ist (d. h. updateStatus ist weder UPDATE_STATUS_UNKNOWN noch UP_TO_DATE).

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

UpdateStatus

Der Status einer Aktualisierung: Gibt an, ob eine Aktualisierung existiert und um welche Art von Update es sich handelt.

Enums
UPDATE_STATUS_UNKNOWN Es ist nicht bekannt, ob ein Systemupdate aussteht. Das passiert beispielsweise, wenn das API-Level des Geräts kleiner als 26 ist oder wenn die Version der Android Device Policy veraltet ist.
UP_TO_DATE Für das Gerät ist kein ausstehendes Systemupdate verfügbar.
UNKNOWN_UPDATE_AVAILABLE Es ist ein ausstehendes Systemupdate verfügbar, aber der Typ ist nicht bekannt.
SECURITY_UPDATE_AVAILABLE Es ist ein ausstehendes Sicherheitsupdate verfügbar.
OS_UPDATE_AVAILABLE Es ist ein ausstehendes Betriebssystemupdate verfügbar.

HardwareInfo

Informationen zur Gerätehardware. Die Felder, die sich auf Temperaturgrenzwerte beziehen, sind nur verfügbar, wenn in der Geräterichtlinie „hardwareStatusEnabled“ „true“ ist.

JSON-Darstellung 
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}
Felder
brand

string

Marke des Geräts. Beispiel: Google.
hardware

string

Name der Hardware. Beispiel: Angler.
deviceBasebandVersion

string

Baseband-Version. Beispiel: MDM9625_104662.22.05.34p.
manufacturer

string

Hersteller. Beispiel: Motorola.
serialNumber

string

Die Seriennummer des Geräts.
model

string

Das Modell des Geräts. Beispiel: Asus Nexus 7.
batteryShutdownTemperatures[]

number

Grenzwerte zum Ausschalten des Akkus für jeden Akku des Geräts in Celsius.
batteryThrottlingTemperatures[]

number

Grenzwerte für die Drosselung des Akkus für jeden Akku des Geräts in Celsius.
cpuShutdownTemperatures[]

number

Grenzwerte zum Ausschalten der CPU für jede CPU auf dem Gerät in Celsius.
cpuThrottlingTemperatures[]

number

Schwellenwerte für die CPU-Drosselung in Celsius für jede CPU auf dem Gerät.
gpuShutdownTemperatures[]

number

Grenzwerte für die Temperaturgrenzwerte zum Herunterfahren von GPUs für jede GPU auf dem Gerät in Celsius.
gpuThrottlingTemperatures[]

number

Schwellenwerte für die GPU-Drosselung in Celsius für jede GPU auf dem Gerät.
skinShutdownTemperatures[]

number

Grenzwerte für die Temperatur beim Ausschalten der Haut des Geräts in Celsius.
skinThrottlingTemperatures[]

number

Schwellenwerte für die Hautdrosselung des Geräts in Celsius.
enterpriseSpecificId

string

Nur Ausgabe Die ID, über die ein privates Gerät in einer bestimmten Organisation eindeutig identifiziert wird. Wenn das Gerät in derselben Organisation registriert ist, bleibt die ID bei allen Einrichtungsschritten und sogar beim Zurücksetzen auf die Werkseinstellungen auf demselben physischen Gerät erhalten. Diese ID ist auf privaten Geräten mit Arbeitsprofil und auf Geräten mit Android 12 oder höher verfügbar.

Display

Informationen zum Gerätedisplay.

JSON-Darstellung 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Felder
name

string

Name der Anzeige.
displayId

integer

Eindeutige Anzeige-ID.
refreshRate

integer

Aktualisierungsrate der Anzeige in Bildern pro Sekunde.
state

enum (DisplayState)

Status des Bildschirms.
width

integer

Anzeigebreite in Pixeln.
height

integer

Anzeigehöhe in Pixeln.
density

integer

Kompaktheitsgrad der Anzeige in Punkten pro Zoll

DisplayState

Der Status einer Anzeige.

Enums
DISPLAY_STATE_UNSPECIFIED Dieser Wert ist nicht zulässig.
OFF Display ist aus.
ON Display ist an.
DOZE Display schlummert im Energiesparmodus
SUSPENDED Das Display schlummert im angehaltenen Modus mit niedrigem Energieverbrauch.

ApplicationReport

Informationen zu einer installierten App.

JSON-Darstellung 
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
Felder
packageName

string

Paketname der App.
versionName

string

Die App-Version, wie sie dem Nutzer angezeigt wird.
versionCode

integer

Der Code der App-Version, mit dem ermittelt werden kann, ob eine Version aktueller ist als eine andere.
events[]

object (ApplicationEvent)

Die Liste der App-Ereignisse, die in den letzten 30 Stunden aufgetreten sind.
displayName

string

Der Anzeigename der App.
packageSha256Hash

string

SHA-256-Hash der APK-Datei der App, mit dem geprüft werden kann, ob die App geändert wurde. Jedes Byte des Hashwerts wird als zweistellige Hexadezimalzahl dargestellt.
signingKeyCertFingerprints[]

string

Der SHA-1-Hash jedes android.content.pm.Signature, der mit dem App-Paket verknüpft ist. Jedes Byte jedes Hashwerts wird als zweistellige Hexadezimalzahl dargestellt.
installerPackageName

string

Paketname der App, mit der diese App installiert wurde
applicationSource

enum (ApplicationSource)

Die Quelle des Pakets.
state

enum (ApplicationState)

Anwendungsstatus.
keyedAppStates[]

object (KeyedAppState)

Liste der von der App gemeldeten Schlüssel-App-Status.
userFacingType

enum (UserFacingType)

Ob die App für Nutzer sichtbar ist.

ApplicationEvent

Ein app-bezogenes Ereignis.

JSON-Darstellung 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Felder
eventType

enum (ApplicationEventType)

App-Ereignistyp.
createTime

string (Timestamp format)

Der Zeitpunkt der Erstellung des Ereignisses.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

ApplicationEventType

Eine Art von App-bezogenes Ereignis.

Enums
APPLICATION_EVENT_TYPE_UNSPECIFIED Dieser Wert ist nicht zulässig.
INSTALLED Die App wurde installiert.
CHANGED Die Anwendung wurde geändert, beispielsweise wurde eine Komponente aktiviert oder deaktiviert.
DATA_CLEARED Die App-Daten wurden gelöscht.
REMOVED Die App wurde entfernt.
REPLACED Eine neue Version der App wurde installiert, die die alte Version ersetzt.
RESTARTED Die App wurde neu gestartet.
PINNED Die App wurde im Vordergrund angepinnt.
UNPINNED Die App wurde losgelöst.

ApplicationSource

Die Quelle, von der die App bereitgestellt wurde.

Enums
APPLICATION_SOURCE_UNSPECIFIED Die App wurde aus einer nicht angegebenen Quelle per Sideload übertragen.
SYSTEM_APP_FACTORY_VERSION Dies ist eine System-App aus dem Factory Image des Geräts.
SYSTEM_APP_UPDATED_VERSION Dies ist eine aktualisierte System-App.
INSTALLED_FROM_PLAY_STORE Die App wurde über den Google Play Store installiert.

ApplicationState

Der aktuelle Installationsstatus.

Enums
APPLICATION_STATE_UNSPECIFIED Anwendungsstatus ist nicht angegeben
REMOVED Die App wurde vom Gerät entfernt
INSTALLED Die App ist auf dem Gerät installiert

KeyedAppState

Von der App gemeldeten App-Status.

JSON-Darstellung 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Felder
key

string

Der Schlüssel für den App-Status. Fungiert als Bezugspunkt dafür, wofür die App den Status bereitstellt. Wenn Sie Feedback zu einer verwalteten Konfiguration geben, kann dieser Schlüssel beispielsweise der verwaltete Konfigurationsschlüssel sein.
severity

enum (Severity)

Der Schweregrad des Anwendungsstatus.
message

string

Optional: ein kostenlos formbarer Nachrichtenstring zur Erläuterung des App-Status. Wenn der Status durch einen bestimmten Wert ausgelöst wurde (z.B. ein Wert einer verwalteten Konfiguration), sollte dieser in der Nachricht enthalten sein.
data

string

Optional ein maschinenlesbarer Wert, der vom EMM gelesen werden soll. Beispielsweise können Sie Werte festlegen, die der Administrator in der EMM-Konsole abfragen kann (z.B. „Benachrichtigen, wenn die Daten für „battery_warning“ < 10 sind“).
createTime

string (Timestamp format)

Der Erstellungszeitpunkt des App-Status auf dem Gerät.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

Der Zeitpunkt, zu dem der Anwendungsstatus zuletzt aktualisiert wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

Schweregrad

Der Schweregrad des Anwendungsstatus.

Enums
SEVERITY_UNSPECIFIED Nicht angegebener Schweregrad.
INFO Schweregrad der Informationen.
ERROR Schweregrad des Fehlers. Dies sollte nur für echte Fehlerbedingungen festgelegt werden, die von einer Verwaltungsorganisation behoben werden müssen.

UserFacingType

Ob die App für Nutzer sichtbar ist.

Enums
USER_FACING_TYPE_UNSPECIFIED Der Typ für Nutzer der App ist nicht angegeben.
NOT_USER_FACING Die App ist nicht für Nutzer sichtbar.
USER_FACING Die App ist an Nutzer gerichtet.

NetworkInfo

Informationen zum Gerätenetzwerk.

JSON-Darstellung 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Felder
imei

string

IMEI-Nummer des GSM-Geräts Beispiel: A1000031212.
meid

string

MEID-Nummer des CDMA-Geräts Beispiel: A00000292788E1.
wifiMacAddress

string

WLAN-MAC-Adresse des Geräts. Beispiel: 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Alphabetischer Name des aktuell registrierten Betreibers. Beispiel: Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Stellt Telefonieinformationen zu jeder SIM-Karte im Gerät bereit. Wird nur auf vollständig verwalteten Geräten ab Android API-Level 23 unterstützt.

TelephonyInfo

Telefonieinformationen, die mit einer bestimmten SIM-Karte auf dem Gerät verknüpft sind Wird nur auf vollständig verwalteten Geräten ab Android API-Level 23 unterstützt.

JSON-Darstellung 
{
  "phoneNumber": string,
  "carrierName": string
}
Felder
phoneNumber

string

Die mit dieser SIM-Karte verknüpfte Telefonnummer.
carrierName

string

Der Name des Mobilfunkanbieters, der mit dieser SIM-Karte verknüpft ist.

MemoryInfo

Informationen zum Arbeitsspeicher und Speicherplatz auf dem Gerät.

JSON-Darstellung 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Felder
totalRam

string (int64 format)

RAM insgesamt auf dem Gerät in Byte.
totalInternalStorage

string (int64 format)

Gesamter interner Speicher auf dem Gerät in Byte.

MemoryEvent

Ein Ereignis im Zusammenhang mit Arbeitsspeicher- und Speichermesswerten.

Damit Sie zwischen neuen und alten Ereignissen unterscheiden können, empfehlen wir die Verwendung des Felds createTime.

JSON-Darstellung 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Felder
eventType

enum (MemoryEventType)

Ereignistyp
createTime

string (Timestamp format)

Der Zeitpunkt der Erstellung des Ereignisses.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

Die Anzahl kostenloser Byte im Medium oder bei EXTERNAL_STORAGE_DETECTED die Gesamtkapazität des Speichermediums in Byte.

MemoryEventType

Der Ereignistyp.

Enums
MEMORY_EVENT_TYPE_UNSPECIFIED Nicht angegeben Es gibt keine Ereignisse dieses Typs.
RAM_MEASURED Der kostenlose Speicherplatz im RAM wurde gemessen.
INTERNAL_STORAGE_MEASURED Der kostenlose Speicherplatz im internen Speicher wurde gemessen.
EXTERNAL_STORAGE_DETECTED Ein neues externes Speichermedium wurde erkannt. Die gemeldete Bytezahl ist die Gesamtkapazität des Speichermediums.
EXTERNAL_STORAGE_REMOVED Ein externes Speichermedium wurde entfernt. Die gemeldete Bytezahl ist null.
EXTERNAL_STORAGE_MEASURED Der kostenlose Speicherplatz auf einem externen Speichermedium wurde gemessen.

PowerManagementEvent

Ein Ereignis zur Energieverwaltung.

JSON-Darstellung 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Felder
eventType

enum (PowerManagementEventType)

Ereignistyp
createTime

string (Timestamp format)

Der Zeitpunkt der Erstellung des Ereignisses.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
batteryLevel

number

Bei BATTERY_LEVEL_COLLECTED-Ereignissen der Akkustand in Prozent.

PowerManagementEventType

Der Ereignistyp.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Nicht angegeben Es gibt keine Ereignisse dieses Typs.
BATTERY_LEVEL_COLLECTED Der Akkustand wurde gemessen.
POWER_CONNECTED Der Ladevorgang hat begonnen.
POWER_DISCONNECTED Der Ladevorgang wurde beendet.
BATTERY_LOW Das Gerät ist in den Energiesparmodus gewechselt.
BATTERY_OKAY Das Gerät hat den Energiesparmodus beendet.
BOOT_COMPLETED Das Gerät wurde gestartet.
SHUTDOWN Das Gerät wurde heruntergefahren.

HardwareStatus

Hardware status. Die Temperaturen können mit den in hardwareInfo verfügbaren Temperaturgrenzwerten verglichen werden, um den Zustand der Hardware zu bestimmen.

JSON-Darstellung 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Felder
createTime

string (Timestamp format)

Die Zeit, zu der die Messungen durchgeführt wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
batteryTemperatures[]

number

Aktuelle Akkutemperaturen für jeden Akku des Geräts in Celsius.
cpuTemperatures[]

number

Aktuelle CPU-Temperaturen in Celsius für jede CPU auf dem Gerät.
gpuTemperatures[]

number

Aktuelle GPU-Temperaturen in Celsius für jede GPU auf dem Gerät.
skinTemperatures[]

number

Aktuelle Hauttemperaturen des Geräts in Celsius.
fanSpeeds[]

number

Lüftergeschwindigkeiten in Umdrehungen pro Lüfter am Gerät. Ein leeres Array bedeutet, dass keine Lüfter vorhanden sind oder die Lüftergeschwindigkeit im System nicht unterstützt wird.
cpuUsages[]

number

CPU-Nutzung in Prozent für jeden auf dem Gerät verfügbaren Kern. Die Nutzung liegt für jeden ausgesteckten Kern bei 0. Ein leeres Array deutet darauf hin, dass die CPU-Nutzung im System nicht unterstützt wird.

DeviceSettings

Informationen zu sicherheitsrelevanten Geräteeinstellungen auf dem Gerät.

JSON-Darstellung 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Felder
isDeviceSecure

boolean

Gibt an, ob das Gerät mit einer PIN/einem Passwort gesichert ist.
unknownSourcesEnabled

boolean

Gibt an, ob die Installation von Apps aus unbekannten Quellen aktiviert ist.
developmentSettingsEnabled

boolean

Gibt an, ob der Entwicklermodus auf dem Gerät aktiviert ist.
adbEnabled

boolean

Gibt an, ob ADB auf dem Gerät aktiviert ist.
isEncrypted

boolean

Gibt an, ob die Speicherverschlüsselung aktiviert ist.
encryptionStatus

enum (EncryptionStatus)

Verschlüsselungsstatus von DevicePolicyManager.
verifyAppsEnabled

boolean

Gibt an, ob die Google Play Protect-Überprüfung auf dem Gerät erzwungen wird.

EncryptionStatus

Verschlüsselungsstatus eines Geräts.

Enums
ENCRYPTION_STATUS_UNSPECIFIED Nicht angegeben Kein Gerät sollte diesen Typ haben.
UNSUPPORTED Verschlüsselung wird vom Gerät nicht unterstützt.
INACTIVE Die Verschlüsselung wird vom Gerät unterstützt, ist aber derzeit nicht aktiv.
ACTIVATING Die Verschlüsselung ist derzeit nicht aktiv, wird aber gerade aktiviert.
ACTIVE Verschlüsselung ist aktiv.
ACTIVE_DEFAULT_KEY Die Verschlüsselung ist aktiv, aber der Nutzer hat keinen Verschlüsselungsschlüssel festgelegt.
ACTIVE_PER_USER Die Verschlüsselung ist aktiv und der Verschlüsselungsschlüssel ist an das Nutzerprofil gebunden.

SecurityPosture

Der Sicherheitsstatus des Geräts gemäß dem aktuellen Gerätestatus und den angewendeten Richtlinien.

JSON-Darstellung 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Felder
devicePosture

enum (DevicePosture)

Der Wert des Sicherheitsstatus des Geräts.
postureDetails[]

object (PostureDetail)

Weitere Informationen zum Sicherheitsstatus des Geräts.

DevicePosture

Mögliche Werte des Sicherheitsstatus eines verwalteten Geräts.

Enums
POSTURE_UNSPECIFIED Nicht angegeben Für diesen Statuswert gibt es keine Statusdetails.
SECURE Dieses Gerät ist sicher.
AT_RISK Dieses Gerät ist möglicherweise anfälliger für böswillige Akteure, als für die Verwendung mit Unternehmensdaten empfohlen wird.
POTENTIALLY_COMPROMISED Dieses Gerät könnte gehackt werden und Unternehmensdaten könnten für nicht autorisierte Personen zugänglich sein.

PostureDetail

Weitere Informationen zum Sicherheitsstatus des Geräts.

JSON-Darstellung 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Felder
securityRisk

enum (SecurityRisk)

Ein bestimmtes Sicherheitsrisiko, das sich negativ auf den Sicherheitsstatus des Geräts auswirkt.
advice[]

object (UserFacingMessage)

Entsprechende Administratortipps, um dieses Sicherheitsrisiko zu mindern und den Sicherheitsstatus des Geräts zu verbessern.

SecurityRisk

Das Risiko, dass das Gerät nicht im sichersten Zustand ist.

Enums
SECURITY_RISK_UNSPECIFIED Nicht angegeben
UNKNOWN_OS Die Play Integrity API erkennt, dass auf dem Gerät ein unbekanntes Betriebssystem ausgeführt wird. DiebasicIntegrity-Prüfung ist erfolgreich, aber „ctsProfileMatch“ schlägt fehl.
COMPROMISED_OS Die Play Integrity API erkennt, dass auf dem Gerät ein manipuliertes Betriebssystem ausgeführt wird (basicIntegrity check schlägt fehl).
HARDWARE_BACKED_EVALUATION_FAILED Die Play Integrity API erkennt, dass das Gerät keine starke Garantie für die Systemintegrität hat, wenn das Label MEETS_STRONG_INTEGRITY nicht im Feld für die Geräteintegrität angezeigt wird.

CommonCriteriaModeInfo

Informationen zum Common-Criteria-Modus – Sicherheitsstandards, die unter Common Criteria for Information Technology Security Evaluation (CC) definiert sind.

Diese Informationen sind nur verfügbar, wenn statusReportingSettings.commonCriteriaModeEnabled in der Richtlinie des Geräts auf true gesetzt ist.

JSON-Darstellung 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
Felder
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Gibt an, ob der Common Criteria-Modus aktiviert ist.

CommonCriteriaModeStatus

Gibt an, ob der Common Criteria-Modus aktiviert ist.

Enums
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Unbekannter Status.
COMMON_CRITERIA_MODE_DISABLED Der Common-Criteria-Modus ist derzeit deaktiviert.
COMMON_CRITERIA_MODE_ENABLED Der Common Criteria-Modus ist derzeit aktiviert.

DpcMigrationInfo

Informationen darüber, ob dieses Gerät von der Verwaltung durch einen anderen Device Policy Controller (DPC) migriert wurde.

JSON-Darstellung 
{
  "previousDpc": string,
  "additionalData": string
}
Felder
previousDpc

string

Nur Ausgabe Wenn dieses Gerät von einem anderen DPC migriert wurde, ist dies der Paketname. Wird nicht anderweitig ausgefüllt.
additionalData

string

Nur Ausgabe Wenn dieses Gerät von einem anderen DPC migriert wurde, enthält das Feld additionalData des Migrationstokens hier einen Eintrag.

Methoden

delete

 Löscht ein Gerät.

get

 Ein Gerät abrufen.

issueCommand

 Gibt einen Befehl an ein Gerät aus.

list

 Listet Geräte für ein bestimmtes Unternehmen auf.

patch

 Aktualisiert ein Gerät.