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 nicht von enterprises.devices.patch 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 Verwaltungstyp, den die Android Device Policy auf dem Gerät übernimmt. Dies wirkt sich darauf aus, welche Richtlinieneinstellungen unterstützt werden.

state

enum (DeviceState)

Der Status, der auf das Gerät angewendet werden soll. Dieses Feld kann durch eine Patch-Anfrage geändert werden. Beachten Sie, dass beim Aufrufen von enterprises.devices.patch nur ACTIVE und DISABLED als Werte zulässig sind. Rufen Sie enterprises.devices.delete auf, um das Gerät in den Status DELETED zu versetzen.

appliedState

enum (DeviceState)

Der Status, der derzeit auf das Gerät angewendet wird.

policyCompliant

boolean

Gibt an, ob das Gerät der Richtlinie entspricht.

nonComplianceDetails[]

object (NonComplianceDetail)

Details zu Richtlinieneinstellungen, die auf dem Gerät nicht eingehalten werden.

enrollmentTime

string (Timestamp format)

Der Zeitpunkt der Geräteregistrierung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

lastStatusReportTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Gerät zuletzt einen Statusbericht gesendet hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Verworfen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

lastPolicySyncTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Gerät zuletzt seine Richtlinie abgerufen hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

policyName

string

Der Name der auf das Gerät angewendeten Richtlinie im Format enterprises/{enterpriseId}/policies/{policyId}. Wenn nichts angegeben ist, wird die policyName für den Nutzer des Geräts angewendet. Dieses Feld kann durch eine Patch-Anfrage geändert werden. Sie können beim Aufrufen von enterprises.devices.patch nur policyId angeben, sofern 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 Android-Plattformversion, die auf dem Gerät ausgeführt wird.

enrollmentTokenData

string

Wenn das Gerät mit einem Registrierungstoken mit zusätzlichen 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 ist, wird auf dem Gerät eine optionale Meldung angezeigt, in der der Grund für die Deaktivierung des Geräts angegeben ist. Dieses Feld kann durch eine Patch-Anfrage geändert werden.

softwareInfo

object (SoftwareInfo)

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

hardwareInfo

object (HardwareInfo)

Detaillierte Informationen zur Gerätehardware.

displays[]

object (Display)

Detaillierte Informationen zu den Displays auf dem Gerät. Diese Informationen sind nur verfügbar, wenn displayInfoEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist.

applicationReports[]

object (ApplicationReport)

Berichte für auf dem Gerät installierte Apps. Diese Informationen sind nur verfügbar, wenn applicationReportsEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist.

previousDeviceNames[]

string

Wenn dasselbe physische Gerät mehrmals registriert wurde, enthält dieses Feld die vorherigen Gerätenamen. Die Seriennummer wird als eindeutige Kennung verwendet, um festzustellen, ob dasselbe physische Gerät bereits registriert wurde. Die Namen sind in chronologischer Reihenfolge aufgeführt.

networkInfo

object (NetworkInfo)

Informationen zum Gerätenetzwerk. Diese Informationen sind nur verfügbar, wenn networkInfoEnabled in der Richtlinie des Geräts 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 Speichermessungen in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn memoryInfoEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist.

Ereignisse werden für einen bestimmten Zeitraum aufbewahrt und alte Ereignisse werden gelöscht.

powerManagementEvents[]

object (PowerManagementEvent)

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

hardwareStatusSamples[]

object (HardwareStatus)

Beispiele für den Hardwarestatus in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn hardwareStatusEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist.

deviceSettings

object (DeviceSettings)

Informationen zu Geräteeinstellungen. Diese Informationen sind nur verfügbar, wenn deviceSettingsEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist.

user

object (User)

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

systemProperties

map (key: string, value: string)

Eine Zuordnung von Namen und Werten ausgewählter Systemeigenschaften, die sich auf das Gerät beziehen. Diese Informationen sind nur verfügbar, wenn systemPropertiesEnabled in der Richtlinie des Geräts 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)

Wert für die Sicherheitslage des Geräts, der angibt, wie sicher das Gerät ist.

ownership

enum (Ownership)

Eigentümerschaft des verwalteten Geräts.

commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informationen zum Common Criteria-Modus – Sicherheitsstandards, die in den 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 true ist und das Gerät unternehmenseigen ist.

appliedPasswordPolicies[]

object (PasswordRequirements)

Die Passwortanforderungen, die derzeit auf das Gerät angewendet werden.

  • Die angewendeten Anforderungen können in einigen Fällen geringfügig von den in passwordPolicies angegebenen Anforderungen abweichen.
  • fieldPath wird basierend auf passwordPolicies festgelegt.
dpcMigrationInfo

object (DpcMigrationInfo)

Nur Ausgabe. Informationen dazu, ob dieses Gerät von einem 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 nie von einem API-Aufruf zurückgegeben, sondern im endgültigen Statusbericht verwendet, wenn das Gerät die Löschung 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 für den Server unbekannt.
PROVISIONING Das Gerät wird bereitgestellt. Neu registrierte Geräte befinden sich in diesem Status, bis eine Richtlinie angewendet wird.
LOST Das Gerät ist verloren gegangen. Dieser Status ist nur auf Geräten möglich, die der Organisation gehören.
PREPARING_FOR_MIGRATION Das Gerät wird für die Migration zur Android Management API vorbereitet. Es sind keine weiteren Maßnahmen erforderlich, damit die Migration fortgesetzt wird.
DEACTIVATED_BY_DEVICE_FINANCE Es handelt sich um ein finanziertes Gerät, das vom Finanzierungsunternehmen „gesperrt“ wurde. Das bedeutet, dass bestimmte Richtlinieneinstellungen angewendet wurden, die die Gerätefunktionen einschränken, bis das Gerät vom Finanzierungsunternehmen „entsperrt“ wurde. Auf dem Gerät werden weiterhin Richtlinieneinstellungen angewendet, mit Ausnahme der Einstellungen, die vom Finanzierungsunternehmen überschrieben werden. Wenn das Gerät „verriegelt“ ist, wird der Status in appliedState als DEACTIVATED_BY_DEVICE_FINANCE gemeldet.

NonComplianceDetail

Enthält Details zur Nichteinhaltung einer 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 der obersten Ebene.

nonComplianceReason

enum (NonComplianceReason)

Der Grund, warum das Gerät nicht der Einstellung entspricht.

packageName

string

Der Paketname der App, die nicht den Richtlinien entspricht, falls zutreffend.

fieldPath

string

Bei Einstellungen mit verschachtelten Feldern wird hier der vollständige Pfad zum entsprechenden Feld angegeben, wenn ein bestimmtes verschachteltes Feld nicht den Richtlinien entspricht. Der Pfad wird auf dieselbe Weise formatiert, wie das JSON-Feld der Richtlinie in JavaScript referenziert würde: 1) Bei Feldern vom Typ „object“ folgt auf den Feldnamen ein Punkt und dann ein Unterfeldname. 2) Bei Feldern vom Typ „Array“ folgt dem Feldnamen der Arrayindex in Klammern. Wenn Sie beispielsweise ein Problem mit dem Feld url im Feld externalData in der dritten Anwendung angeben möchten, lautet der Pfad applications[2].externalData.url.

currentValue

value (Value format)

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

installationFailureReason

enum (InstallationFailureReason)

Wenn packageName festgelegt ist und der Grund für die Richtlinienverstöße APP_NOT_INSTALLED oder APP_NOT_UPDATED ist, wird hier der detaillierte Grund dafür angegeben, warum die App nicht installiert oder aktualisiert werden kann.

specificNonComplianceReason

enum (SpecificNonComplianceReason)

Der richtlinienspezifische Grund, warum das Gerät nicht der Einstellung entspricht.

specificNonComplianceContext

object (SpecificNonComplianceContext)

Zusätzlicher Kontext für specificNonComplianceReason.

InstallationFailureReason

Gründe für das Fehlschlagen einer App-Installation.

Enums
INSTALLATION_FAILURE_REASON_UNSPECIFIED Dieser Wert ist nicht zulässig.
INSTALLATION_FAILURE_REASON_UNKNOWN Ein unbekannter Fehler 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 noch einmal versucht.
IN_PROGRESS Die Installation wird noch ausgeführt.
NOT_FOUND Die App wurde bei Google Play nicht gefunden.
NOT_COMPATIBLE_WITH_DEVICE Die App ist mit dem Gerät nicht kompatibel.
NOT_APPROVED Die App wurde vom Administrator nicht genehmigt.
PERMISSIONS_NOT_ACCEPTED Die App hat neue Berechtigungen, die vom Administrator 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 für 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 verhindert, dass die Installation erfolgreich abgeschlossen werden konnte. Das passiert in der Regel, wenn die Internetverbindung des Geräts schlecht oder nicht verfügbar ist oder ein Problem mit der Netzwerkkonfiguration vorliegt. Achte darauf, dass das Gerät über ein Netzwerk, das Android Enterprise Network Requirements entspricht, auf das Internet zugreifen kann. Die Installation oder Aktualisierung der App wird dann automatisch fortgesetzt.

INSUFFICIENT_STORAGE Auf dem Gerät des Nutzers ist nicht genügend Speicherplatz vorhanden, um die App zu installieren. Das Problem kann behoben werden, indem Speicherplatz auf dem Gerät freigegeben wird. Die Installation oder Aktualisierung der App wird automatisch fortgesetzt, sobald auf dem Gerät wieder ausreichend Speicherplatz verfügbar ist.

SpecificNonComplianceReason

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

Enums
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Es wurde kein konkreter Grund für die Nichteinhaltung angegeben. Felder in specificNonComplianceContext sind nicht festgelegt.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Der Nutzer muss die Anmeldedaten bestätigen, indem er die Displaysperre eingibt. 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 erfüllt nicht die Passwortanforderungen. passwordPoliciesContext ist festgelegt. nonComplianceReason ist auf USER_ACTION gesetzt.
ONC_WIFI_INVALID_VALUE In der ONC-WLAN-Konfiguration ist ein falscher Wert enthalten. 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 im 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 WLAN-Netzwerk des Unternehmens fehlen 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 über das Feld ClientCertKeyPairAlias in openNetworkConfiguration angegebene Alias für das Schlüsselpaar entspricht keinem auf dem Gerät installierten Schlüssel. nonComplianceReason ist auf INVALID_VALUE gesetzt.
PERMISSIBLE_USAGE_RESTRICTION Diese Richtlinieneinstellung ist eingeschränkt und kann für dieses Google Cloud-Projekt nicht festgelegt werden. Weitere Informationen, einschließlich der Aktivierung dieser Richtlinieneinstellung, finden Sie in der Richtlinie zur zulässigen Nutzung. nonComplianceReason ist auf PROJECT_NOT_PERMITTED gesetzt.
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE Das Arbeitskonto, das für die Richtlinieneinstellung „workAccountSetupConfig“ erforderlich ist, gehört nicht mehr zum Unternehmen. nonComplianceReason ist auf USER_ACTION gesetzt.
NEW_ACCOUNT_NOT_IN_ENTERPRISE Das vom Nutzer hinzugefügte Arbeitskonto gehört nicht zum Unternehmen. nonComplianceReason ist auf USER_ACTION gesetzt.

SpecificNonComplianceContext

Zusätzlicher Kontext für SpecificNonComplianceReason.

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

object (OncWifiContext)

Zusätzlicher Kontext für die Nichteinhaltung von Richtlinien in Bezug auf die WLAN-Konfiguration. Weitere Informationen finden Sie unter ONC_WIFI_INVALID_VALUE und ONC_WIFI_API_LEVEL.

passwordPoliciesContext

object (PasswordPoliciesContext)

Zusätzlicher Kontext für die Nichteinhaltung von Passwortrichtlinien. Weitere Informationen finden Sie unter PASSWORD_POLICIES_PASSWORD_EXPIRED und PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Zusätzlicher Kontext für die Nichteinhaltung von Richtlinien in Bezug auf die WLAN-Konfiguration.

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

string

Die GUID der nicht konformen WLAN-Konfiguration.

PasswordPoliciesContext

Zusätzlicher Kontext für die Nichteinhaltung von Passwortrichtlinien.

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

enum (PasswordPolicyScope)

Der 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 Android-Versionsstring. Beispiel: 6.0.1.

androidDevicePolicyVersionCode

integer

Der Versionscode der Android Device Policy App.

androidDevicePolicyVersionName

string

Die Version der Android Device Policy App, die dem Nutzer angezeigt wird.

androidBuildNumber

string

Die Android-Build-ID-String, die 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-Dauer

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

securityPatchLevel

string

Sicherheitspatch-Level, z.B. 2016-05-01.

primaryLanguageCode

string

Ein Sprachcode nach IETF BCP 47 für das primäre Gebietsschema auf dem Gerät.

deviceBuildSignature

string

SHA-256-Hash von android.content.pm.Signature, der mit dem Systempaket verknüpft ist. Er kann verwendet werden, um zu prüfen, ob der Systembuild geändert wurde.

systemUpdateInfo

object (SystemUpdateInfo)

Informationen zu einem potenziell ausstehenden Systemupdate.

SystemUpdateInfo

Informationen zu einem potenziell ausstehenden Systemupdate.

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

enum (UpdateStatus)

Der Status eines Updates: ob ein Update vorhanden ist und welcher Art es ist.

updateReceivedTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Update zum ersten Mal verfügbar war. Ein Nullwert gibt an, 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).

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

UpdateStatus

Der Status eines Updates: ob ein Update vorhanden ist und welcher Art es ist.

Enums
UPDATE_STATUS_UNKNOWN Es ist nicht bekannt, ob ein Systemupdate aussteht. Das kann beispielsweise passieren, wenn das API-Level des Geräts niedriger als 26 ist oder wenn die Version der Android Device Policy App veraltet ist.
UP_TO_DATE Auf dem Gerät ist kein ausstehendes Systemupdate verfügbar.
UNKNOWN_UPDATE_AVAILABLE Es ist ein ausstehendes Systemupdate verfügbar, dessen Typ jedoch nicht bekannt ist.
SECURITY_UPDATE_AVAILABLE Es ist ein ausstehendes Sicherheitsupdate verfügbar.
OS_UPDATE_AVAILABLE Ein ausstehendes Betriebssystemupdate ist verfügbar.

HardwareInfo

Informationen zur Gerätehardware. Die Felder für Temperaturschwellenwerte sind nur verfügbar, wenn hardwareStatusEnabled in der Richtlinie des Geräts auf „true“ gesetzt 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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
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

Temperaturschwellen für das Herunterfahren des Akkus in Grad Celsius für jeden Akku auf dem Gerät.

batteryThrottlingTemperatures[]

number

Temperaturschwellen für die Akku-Drosselung in Grad Celsius für jeden Akku auf dem Gerät.

cpuShutdownTemperatures[]

number

CPU-Abschalttemperaturschwellenwerte in Grad Celsius für jede CPU auf dem Gerät.

cpuThrottlingTemperatures[]

number

Temperaturschwellen für die CPU-Drosselung in Grad Celsius für jede CPU auf dem Gerät.

gpuShutdownTemperatures[]

number

GPU-Abschalttemperaturschwellenwerte in Grad Celsius für jede GPU auf dem Gerät.

gpuThrottlingTemperatures[]

number

Temperaturschwellen für die GPU-Drosselung in Grad Celsius für jede GPU auf dem Gerät.

skinShutdownTemperatures[]

number

Grenzwerte für die Abschaltung des Geräts aufgrund der Hauttemperatur in Grad Celsius.

skinThrottlingTemperatures[]

number

Grenzwerte für die Drosselung der Hauttemperatur des Geräts in Grad Celsius.

enterpriseSpecificId

string

Nur Ausgabe. ID, die ein privates Gerät in einer bestimmten Organisation eindeutig identifiziert. Auf demselben physischen Gerät, wenn es bei derselben Organisation registriert ist, bleibt diese ID bei der Einrichtung und sogar beim Zurücksetzen auf die Werkseinstellungen erhalten. Diese ID ist auf privaten Geräten mit einem Arbeitsprofil auf Geräten mit Android 12 und höher verfügbar.

euiccChipInfo[]

object (EuiccChipInfo)

Nur Ausgabe. Informationen zum eUICC-Chip.

EuiccChipInfo

Informationen zum eUICC-Chip.

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

string

Nur Ausgabe. Die EID (Embedded Identity Document), die den eUICC-Chip für jeden eUICC-Chip auf dem Gerät identifiziert. Diese Funktion ist auf unternehmenseigenen Geräten mit Android 13 und 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 des Displays.

displayId

integer

Eindeutige Display-ID.

refreshRate

integer

Aktualisierungsrate des Displays in Bildern pro Sekunde.

state

enum (DisplayState)

Status des Displays.

width

integer

Breite des Displays in Pixeln.

height

integer

Höhe des Displays in Pixeln.

density

integer

Die Kompaktheitsdichte wird als „dots-per-inch“ (DPI) angegeben.

DisplayState

Der Status eines Displays.

Enums
DISPLAY_STATE_UNSPECIFIED Dieser Wert ist nicht zulässig.
OFF Das Display ist aus.
ON Das Display ist eingeschaltet.
DOZE Display befindet sich im Doze-Modus (Energiesparmodus)
SUSPENDED Das Display befindet sich im Ruhezustand und ist in einem inaktiven Energiesparmodus.

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, die dem Nutzer angezeigt wird.

versionCode

integer

Der App-Versionscode, mit dem sich feststellen lässt, ob eine Version neuer als eine andere ist.

events[]

object (ApplicationEvent)

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

displayName

string

Der Anzeigename der App.

packageSha256Hash

string

Der SHA-256-Hash der APK-Datei der App, mit dem überprü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, das mit dem App-Paket verknüpft ist. Jedes Byte jedes Hashwerts wird als zweistellige Hexadezimalzahl dargestellt.

installerPackageName

string

Der Paketname der App, über die diese App installiert wurde.

applicationSource

enum (ApplicationSource)

Die Quelle des Pakets.

state

enum (ApplicationState)

Anwendungsstatus.

keyedAppStates[]

object (KeyedAppState)

Liste der von der App gemeldeten App-Zustände mit Schlüssel.

userFacingType

enum (UserFacingType)

Gibt an, ob die App für Nutzer bestimmt ist.

ApplicationEvent

Ein App-bezogenes Ereignis.

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

enum (ApplicationEventType)

App-Ereignistyp.

createTime

string (Timestamp format)

Die Erstellungszeit des Ereignisses.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

ApplicationEventType

Eine Art von app-bezogenem Ereignis.

Enums
APPLICATION_EVENT_TYPE_UNSPECIFIED Dieser Wert ist nicht zulässig.
INSTALLED Die App wurde installiert.
CHANGED Die App wurde geändert, z. B. 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 und hat die alte Version ersetzt.
RESTARTED Die App wurde neu gestartet.
PINNED Die App wurde im Vordergrund fixiert.
UNPINNED Die App wurde vom Bildschirm losgelöst.

ApplicationSource

Die Quelle, über die eine App bereitgestellt wurde.

Enums
APPLICATION_SOURCE_UNSPECIFIED Die App wurde aus einer nicht näher bezeichneten Quelle per Sideloading installiert.
SYSTEM_APP_FACTORY_VERSION Dies ist eine System-App aus dem Werks-Image des Geräts.
SYSTEM_APP_UPDATED_VERSION Dies ist eine aktualisierte System-App.
INSTALLED_FROM_PLAY_STORE Die App wurde aus dem Google Play Store installiert.

ApplicationState

Der aktuelle Installationsstatus.

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

KeyedAppState

Schlüsselbasierter App-Status, der von der App gemeldet wird.

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. Dient als Referenzpunkt für den Status, den die App bereitstellt. Wenn Sie beispielsweise Feedback zur verwalteten Konfiguration geben, kann dieser Schlüssel der Schlüssel für die verwaltete Konfiguration sein.

severity

enum (Severity)

Der Schweregrad des App-Status.

message

string

Optional: Ein Freitextstring, der den App-Status erläutert. Wenn der Status durch einen bestimmten Wert ausgelöst wurde (z.B. einen Wert für die verwaltete Konfiguration), sollte er in der Nachricht enthalten sein.

data

string

Optional: Ein maschinenlesbarer Wert, der vom EMM gelesen werden soll. Beispiel: Werte festlegen, die der Administrator in der EMM-Konsole abfragen kann (z.B. „Benachrichtige mich, wenn die Daten für battery_warning < 10 sind“).

createTime

string (Timestamp format)

Der Zeitpunkt, zu dem der App-Status auf dem Gerät erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

lastUpdateTime

string (Timestamp format)

Der Zeitpunkt, zu dem der App-Status zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Schweregrad

Der Schweregrad des App-Status.

Enums
SEVERITY_UNSPECIFIED Schweregrad nicht angegeben.
INFO Schweregrad der Information.
ERROR Schweregrad des Fehlers. Diese sollte nur für echte Fehlerbedingungen festgelegt werden, die eine Verwaltungsorganisation beheben muss.

UserFacingType

Gibt an, ob die App für Nutzer bestimmt ist.

Enums
USER_FACING_TYPE_UNSPECIFIED Der Typ der App-Nutzer ist nicht angegeben.
NOT_USER_FACING Die App ist nicht für Nutzer bestimmt.
USER_FACING Die App ist für Nutzer bestimmt.

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. Zum Beispiel Vodafone.

telephonyInfos[]

object (TelephonyInfo)

Stellt Telefonieinformationen für jede SIM-Karte auf dem 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,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
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.

iccId

string

Nur Ausgabe. Die ICCID, die mit dieser SIM-Karte verknüpft ist.

activationState

enum (ActivationState)

Nur Ausgabe. Aktivierungsstatus der SIM-Karte auf dem Gerät. Dies gilt nur für eSIMs. Diese Funktion wird auf allen Geräten mit API-Level 35 und höher unterstützt. Für physische SIMs und Geräte unter API-Level 35 ist dies immer ACTIVATION_STATE_UNSPECIFIED.

configMode

enum (ConfigMode)

Nur Ausgabe. Der Konfigurationsmodus der SIM-Karte auf dem Gerät. Dies gilt nur für eSIMs. Diese Funktion wird auf allen Geräten mit API-Level 35 und höher unterstützt. Für physische SIMs und Geräte unter API-Level 35 ist dies immer CONFIG_MODE_UNSPECIFIED.

ActivationState

Aktivierungsstatus der SIM-Karte auf dem Gerät.

Enums
ACTIVATION_STATE_UNSPECIFIED Der Aktivierungsstatus ist nicht angegeben.
ACTIVATED Die SIM-Karte ist aktiviert.
NOT_ACTIVATED Die SIM-Karte ist nicht aktiviert.

ConfigMode

Der Konfigurationsmodus der SIM-Karte auf dem Gerät.

Enums
CONFIG_MODE_UNSPECIFIED Der Konfigurationsmodus wurde nicht angegeben.
ADMIN_CONFIGURED Der Administrator hat diese SIM-Karte konfiguriert.
USER_CONFIGURED Der Nutzer hat diese SIM-Karte konfiguriert.

MemoryInfo

Informationen zum Arbeitsspeicher und Speicherplatz von Geräten.

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

string (int64 format)

Gesamter RAM 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 Speichermessungen.

Um zwischen neuen und alten Ereignissen zu unterscheiden, 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)

Die Erstellungszeit des Ereignisses.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

byteCount

string (int64 format)

Die Anzahl der kostenlosen Byte auf dem Medium oder für EXTERNAL_STORAGE_DETECTED die Gesamtkapazität des Speichermediums in Byte.

MemoryEventType

Der Ereignistyp.

Enums
MEMORY_EVENT_TYPE_UNSPECIFIED Nicht angegeben Keine Ereignisse haben diesen Typ.
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 angegebene Byteanzahl entspricht der Gesamtkapazität des Speichermediums.
EXTERNAL_STORAGE_REMOVED Ein externes Speichermedium wurde entfernt. Die angegebene Byteanzahl ist null.
EXTERNAL_STORAGE_MEASURED Es wurde freier Speicherplatz auf einem externen Speichermedium gemessen.

PowerManagementEvent

Ein Ereignis zur Energieverwaltung.

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

enum (PowerManagementEventType)

Ereignistyp

createTime

string (Timestamp format)

Die Erstellungszeit des Ereignisses.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

batteryLevel

number

Für BATTERY_LEVEL_COLLECTED-Ereignisse wird der Akkustand in Prozent angegeben.

PowerManagementEventType

Der Ereignistyp.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Nicht angegeben Keine Ereignisse haben diesen Typ.
BATTERY_LEVEL_COLLECTED Der Akkustand wurde gemessen.
POWER_CONNECTED Das Gerät wird geladen.
POWER_DISCONNECTED Das Gerät wird nicht mehr geladen.
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 hochgefahren.
SHUTDOWN Das Gerät wurde heruntergefahren.

HardwareStatus

Hardwarestatus Die Temperaturen können mit den in hardwareInfo verfügbaren Temperaturschwellenwerten verglichen werden, um den Hardwarezustand zu ermitteln.

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

string (Timestamp format)

Der Zeitpunkt, zu dem die Messungen durchgeführt wurden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

batteryTemperatures[]

number

Aktuelle Akkutemperaturen in Grad Celsius für jeden Akku im Gerät.

cpuTemperatures[]

number

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

gpuTemperatures[]

number

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

skinTemperatures[]

number

Aktuelle Hauttemperaturen des Geräts in Grad Celsius.

fanSpeeds[]

number

Lüfterdrehzahlen in U/min für jeden Lüfter auf dem Gerät. Ein leeres Array bedeutet, dass es keine Lüfter gibt oder die Lüftergeschwindigkeit auf dem System nicht unterstützt wird.

cpuUsages[]

number

CPU-Nutzung in Prozent für jeden auf dem Gerät verfügbaren Kern. Die Nutzung ist für jeden nicht angeschlossenen Kern 0. Ein leeres Array bedeutet, 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 oder einem Passwort geschützt 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 Das Gerät unterstützt keine Verschlüsselung.
INACTIVE Das Gerät unterstützt die Verschlüsselung, sie ist aber derzeit nicht aktiv.
ACTIVATING Die Verschlüsselung ist derzeit nicht aktiv, wird aber gerade aktiviert.
ACTIVE Die 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 mit dem Nutzerprofil verknüpft.

SecurityPosture

Der Sicherheitsstatus des Geräts, der durch den aktuellen Gerätestatus und die angewendeten Richtlinien bestimmt wird.

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

enum (DevicePosture)

Wert für den Sicherheitsstatus des Geräts.

postureDetails[]

object (PostureDetail)

Zusätzliche Details zum Sicherheitsstatus des Geräts.

DevicePosture

Mögliche Werte für den Sicherheitsstatus eines verwalteten Geräts.

Enums
POSTURE_UNSPECIFIED Nicht angegeben Für diesen Statuswert sind keine Statusdetails vorhanden.
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.
POTENTIALLY_COMPROMISED Dieses Gerät wurde möglicherweise gehackt und Unternehmensdaten sind möglicherweise für nicht autorisierte Personen zugänglich.

PostureDetail

Zusätzliche Details zum Sicherheitsstatus des Geräts.

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

enum (SecurityRisk)

Ein bestimmtes Sicherheitsrisiko, das sich negativ auf die Sicherheit des Geräts auswirkt.

advice[]

object (UserFacingMessage)

Entsprechende Empfehlungen für Administratoren, um dieses Sicherheitsrisiko zu minimieren und den Sicherheitsstatus des Geräts zu verbessern.

SecurityRisk

Das Risiko, das dazu führt, dass sich das Gerät nicht im sichersten Zustand befindet.

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

CommonCriteriaModeInfo

Informationen zum Common Criteria-Modus – Sicherheitsstandards, die in den 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 festgelegt ist.

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

enum (CommonCriteriaModeStatus)

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

policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Nur Ausgabe. Der Status der Überprüfung der Richtliniensignatur.

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.

PolicySignatureVerificationStatus

Der Status der Überprüfung der Richtliniensignatur.

Enums
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Nicht angegeben Der Bestätigungsstatus wurde nicht gemeldet. Wird nur festgelegt, wenn statusReportingSettings.commonCriteriaModeEnabled „false“ ist.
POLICY_SIGNATURE_VERIFICATION_DISABLED Die Überprüfung der Richtliniensignatur ist auf dem Gerät deaktiviert, da commonCriteriaMode auf „false“ gesetzt ist.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED Die Überprüfung der Richtliniensignatur war erfolgreich.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED Die Überprüfung der Richtliniensignatur wird nicht unterstützt, z.B. weil das Gerät mit einer CloudDPC-Version registriert wurde, die die Überprüfung der Richtliniensignatur nicht unterstützt.
POLICY_SIGNATURE_VERIFICATION_FAILED Die Überprüfung der Richtliniensignatur ist fehlgeschlagen. Die Richtlinie wurde nicht angewendet.

DpcMigrationInfo

Informationen dazu, ob dieses Gerät von einem 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 Geräteinhaberprofil-Controller migriert wurde, ist dies der Paketname. Andernfalls nicht ausgefüllt.

additionalData

string

Nur Ausgabe. Wenn dieses Gerät von einem anderen DPC migriert wurde, wird das Feld additionalData des Migrationstokens hier eingefügt.

Methoden

delete

Löscht ein Gerät.

get

Ruft ein Gerät ab.

issueCommand

Gibt einen Befehl an ein Gerät aus.

list

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

patch

Aktualisiert ein Gerät.