- Ressource: Gerät
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext:
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Displaykampagnen
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Schweregrad
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- DpcMigrationInfo
- Methoden
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 ( |
Felder | |
---|---|
name |
Der Name des Geräts im Format |
userName |
Der Ressourcenname des Nutzers, dem dieses Gerät gehört, im Format |
managementMode |
Der Verwaltungsmodus, den die Android Device Policy auf dem Gerät übernimmt. Das hat Einfluss darauf, welche Richtlinieneinstellungen unterstützt werden. |
state |
Der Status, der auf das Gerät angewendet werden soll. Dieses Feld kann durch eine Patchanfrage geändert werden. Beim Aufrufen von |
appliedState |
Der aktuell auf das Gerät angewendete Status. |
policyCompliant |
Gibt an, ob das Gerät den Richtlinien entspricht. |
nonComplianceDetails[] |
Details zu Richtlinieneinstellungen, mit denen das Gerät nicht konform ist. |
enrollmentTime |
Der Zeitpunkt der Geräteregistrierung. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
lastStatusReportTime |
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: |
lastPolicyComplianceReportTime |
Veraltet. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
lastPolicySyncTime |
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: |
policyName |
Der Name der Richtlinie, die auf das Gerät angewendet wird, im Format |
appliedPolicyName |
Der Name der Richtlinie, die derzeit auf das Gerät angewendet wird. |
appliedPolicyVersion |
Die Version der Richtlinie, die derzeit auf das Gerät angewendet wird. |
apiLevel |
Das API-Level der Version der Android-Plattform, die auf dem Gerät ausgeführt wird. |
enrollmentTokenData |
Wenn das Gerät mit einem Registrierungstoken und zusätzlich bereitgestellten Daten registriert wurde, enthält dieses Feld diese Daten. |
enrollmentTokenName |
Wenn das Gerät mit einem Registrierungstoken registriert wurde, enthält dieses Feld den Namen des Tokens. |
disabledReason |
Wenn der Gerätestatus „ |
softwareInfo |
Detaillierte Informationen zur Gerätesoftware. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
hardwareInfo |
Detaillierte Informationen zur Gerätehardware. |
displays[] |
Detaillierte Informationen zu den Bildschirmen auf dem Gerät. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
applicationReports[] |
Berichte für Apps, die auf dem Gerät installiert sind. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
previousDeviceNames[] |
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 |
Informationen zum Gerätenetzwerk. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
memoryInfo |
Arbeitsspeicherinformationen: enthält Informationen zum Arbeitsspeicher und Speicherplatz des Geräts. |
memoryEvents[] |
Ereignisse im Zusammenhang mit Arbeitsspeicher- und Speichermesswerten in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ Termine werden für einen bestimmten Zeitraum aufbewahrt und alte werden gelöscht. |
powerManagementEvents[] |
Ereignisse zur Energieverwaltung auf dem Gerät in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
hardwareStatusSamples[] |
Beispiele zum Hardwarestatus in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
deviceSettings |
Informationen zu den Geräteeinstellungen. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ |
user |
Der Nutzer, dem das Gerät gehört. |
systemProperties |
Karte der ausgewählten Systemeigenschaften, die sich auf das Gerät beziehen. Diese Informationen sind nur verfügbar, wenn in der Geräterichtlinie „ Ein Objekt, das eine Liste von |
securityPosture |
Der Wert des Sicherheitsstatus des Geräts, der angibt, wie sicher das Gerät ist. |
ownership |
Inhaberschaft des verwalteten Geräts |
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 „ |
appliedPasswordPolicies[] |
Die Passwortanforderungen, die aktuell für das Gerät gelten.
|
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 ( |
Felder | |
---|---|
settingName |
Der Name der Richtlinieneinstellung. Dies ist der JSON-Feldname eines |
nonComplianceReason |
Der Grund, warum das Gerät die Einstellung nicht erfüllt. |
packageName |
Der Paketname, der angibt, welche App gegen die Nutzungsbedingungen verstößt, sofern zutreffend. |
fieldPath |
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 |
currentValue |
Wenn die Richtlinieneinstellung nicht angewendet werden konnte, der aktuelle Wert der Einstellung auf dem Gerät. |
installationFailureReason |
Wenn |
specificNonComplianceReason |
Der richtlinienspezifische Grund, warum das Gerät die Einstellung nicht erfüllt. |
specificNonComplianceContext |
Zusätzlicher Kontext für |
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 |
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 sind nicht festgelegt. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
Der Nutzer muss die Anmeldedaten durch Eingabe der Displaysperre bestätigen. Felder in sind nicht festgelegt. ist auf gesetzt. |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
Das Geräte- oder Profilpasswort ist abgelaufen. ist festgelegt. ist auf gesetzt. |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
Das Gerätepasswort entspricht nicht den Passwortanforderungen. ist festgelegt. ist auf gesetzt. |
ONC_WIFI_INVALID_VALUE |
In der ONC-WLAN-Konfiguration ist ein falscher Wert. gibt an, welcher Feldwert falsch ist. ist festgelegt. ist auf 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. gibt an, welcher Feldwert nicht unterstützt wird. ist festgelegt. ist auf gesetzt. |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Im Unternehmens-WLAN fehlt entweder die Stammzertifizierungsstelle oder der Domainname. ist auf 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. ist auf gesetzt. |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
Der im Feld ClientCertKeyPairAlias in angegebene Schlüsselpaar-Alias entspricht keinem vorhandenen Schlüssel, der auf dem Gerät installiert ist. ist auf gesetzt. |
SpecificNonComplianceContext
Zusätzlicher Kontext für
.SpecificNonComplianceReason
JSON-Darstellung |
---|
{ "oncWifiContext": { object ( |
Felder | |
---|---|
oncWifiContext |
Zusätzlicher Kontext bei Nichteinhaltung der WLAN-Konfiguration. Siehe |
passwordPoliciesContext |
Zusätzlicher Kontext bei Nichteinhaltung der Passwortrichtlinien. Weitere Informationen findest du unter |
OncWifiContext
Zusätzlicher Kontext bei Nichteinhaltung der WLAN-Konfiguration.
JSON-Darstellung |
---|
{ "wifiGuid": string } |
Felder | |
---|---|
wifiGuid |
Die GUID der nicht konformen WLAN-Konfiguration. |
PasswordPoliciesContext
Zusätzlicher Kontext bei Nichteinhaltung der Passwortrichtlinien.
JSON-Darstellung |
---|
{
"passwordPolicyScope": enum ( |
Felder | |
---|---|
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 ( |
Felder | |
---|---|
androidVersion |
Der für den Nutzer sichtbare String der Android-Version. Beispiel: |
androidDevicePolicyVersionCode |
Der Versionscode der Android Device Policy App |
androidDevicePolicyVersionName |
Die Version der Android Device Policy App, wie sie dem Nutzer angezeigt wird. |
androidBuildNumber |
Android-Build-ID-String, der dem Nutzer angezeigt werden soll. Beispiel: |
deviceKernelVersion |
Kernel-Version, z. B. |
bootloaderVersion |
Die Versionsnummer des System-Bootloaders, z.B. |
androidBuildTime |
Build-Zeit. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
securityPatchLevel |
Stand der Sicherheitsupdates, z.B. |
primaryLanguageCode |
Ein IETF-BCP-47-Sprachcode für die primäre Sprache auf dem Gerät. |
deviceBuildSignature |
SHA-256-Hash von |
systemUpdateInfo |
Informationen zu einem möglicherweise ausstehenden Systemupdate. |
SystemUpdateInfo
Informationen zu einem möglicherweise ausstehenden Systemupdate.
JSON-Darstellung |
---|
{
"updateStatus": enum ( |
Felder | |
---|---|
updateStatus |
Der Status einer Aktualisierung: Gibt an, ob eine Aktualisierung existiert und um welche Art von Update es sich handelt. |
updateReceivedTime |
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. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
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 |
Marke des Geräts. Beispiel: |
hardware |
Name der Hardware. Beispiel: |
deviceBasebandVersion |
Baseband-Version. Beispiel: |
manufacturer |
Hersteller. Beispiel: |
serialNumber |
Die Seriennummer des Geräts. |
model |
Das Modell des Geräts. Beispiel: |
batteryShutdownTemperatures[] |
Grenzwerte zum Ausschalten des Akkus für jeden Akku des Geräts in Celsius. |
batteryThrottlingTemperatures[] |
Grenzwerte für die Drosselung des Akkus für jeden Akku des Geräts in Celsius. |
cpuShutdownTemperatures[] |
Grenzwerte zum Ausschalten der CPU für jede CPU auf dem Gerät in Celsius. |
cpuThrottlingTemperatures[] |
Schwellenwerte für die CPU-Drosselung in Celsius für jede CPU auf dem Gerät. |
gpuShutdownTemperatures[] |
Grenzwerte für die Temperaturgrenzwerte zum Herunterfahren von GPUs für jede GPU auf dem Gerät in Celsius. |
gpuThrottlingTemperatures[] |
Schwellenwerte für die GPU-Drosselung in Celsius für jede GPU auf dem Gerät. |
skinShutdownTemperatures[] |
Grenzwerte für die Temperatur beim Ausschalten der Haut des Geräts in Celsius. |
skinThrottlingTemperatures[] |
Schwellenwerte für die Hautdrosselung des Geräts in Celsius. |
enterpriseSpecificId |
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 ( |
Felder | |
---|---|
name |
Name der Anzeige. |
displayId |
Eindeutige Anzeige-ID. |
refreshRate |
Aktualisierungsrate der Anzeige in Bildern pro Sekunde. |
state |
Status des Bildschirms. |
width |
Anzeigebreite in Pixeln. |
height |
Anzeigehöhe in Pixeln. |
density |
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 ( |
Felder | |
---|---|
packageName |
Paketname der App. |
versionName |
Die App-Version, wie sie dem Nutzer angezeigt wird. |
versionCode |
Der Code der App-Version, mit dem ermittelt werden kann, ob eine Version aktueller ist als eine andere. |
events[] |
Die Liste der App-Ereignisse, die in den letzten 30 Stunden aufgetreten sind. |
displayName |
Der Anzeigename der App. |
packageSha256Hash |
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[] |
Der SHA-1-Hash jedes |
installerPackageName |
Paketname der App, mit der diese App installiert wurde |
applicationSource |
Die Quelle des Pakets. |
state |
Anwendungsstatus. |
keyedAppStates[] |
Liste der von der App gemeldeten Schlüssel-App-Status. |
userFacingType |
Ob die App für Nutzer sichtbar ist. |
ApplicationEvent
Ein app-bezogenes Ereignis.
JSON-Darstellung |
---|
{
"eventType": enum ( |
Felder | |
---|---|
eventType |
App-Ereignistyp. |
createTime |
Der Zeitpunkt der Erstellung des Ereignisses. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
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 ( |
Felder | |
---|---|
key |
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 |
Der Schweregrad des Anwendungsstatus. |
message |
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 |
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 |
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: |
lastUpdateTime |
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: |
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 ( |
Felder | |
---|---|
imei |
IMEI-Nummer des GSM-Geräts Beispiel: |
meid |
MEID-Nummer des CDMA-Geräts Beispiel: |
wifiMacAddress |
WLAN-MAC-Adresse des Geräts. Beispiel: |
networkOperatorName |
Alphabetischer Name des aktuell registrierten Betreibers. Beispiel: Vodafone. |
telephonyInfos[] |
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 |
Die mit dieser SIM-Karte verknüpfte Telefonnummer. |
carrierName |
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 |
RAM insgesamt auf dem Gerät in Byte. |
totalInternalStorage |
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 ( |
Felder | |
---|---|
eventType |
Ereignistyp |
createTime |
Der Zeitpunkt der Erstellung des Ereignisses. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
byteCount |
Die Anzahl kostenloser Byte im Medium oder bei |
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 ( |
Felder | |
---|---|
eventType |
Ereignistyp |
createTime |
Der Zeitpunkt der Erstellung des Ereignisses. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
batteryLevel |
Bei |
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 |
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: |
batteryTemperatures[] |
Aktuelle Akkutemperaturen für jeden Akku des Geräts in Celsius. |
cpuTemperatures[] |
Aktuelle CPU-Temperaturen in Celsius für jede CPU auf dem Gerät. |
gpuTemperatures[] |
Aktuelle GPU-Temperaturen in Celsius für jede GPU auf dem Gerät. |
skinTemperatures[] |
Aktuelle Hauttemperaturen des Geräts in Celsius. |
fanSpeeds[] |
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[] |
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 ( |
Felder | |
---|---|
isDeviceSecure |
Gibt an, ob das Gerät mit einer PIN/einem Passwort gesichert ist. |
unknownSourcesEnabled |
Gibt an, ob die Installation von Apps aus unbekannten Quellen aktiviert ist. |
developmentSettingsEnabled |
Gibt an, ob der Entwicklermodus auf dem Gerät aktiviert ist. |
adbEnabled |
Gibt an, ob ADB auf dem Gerät aktiviert ist. |
isEncrypted |
Gibt an, ob die Speicherverschlüsselung aktiviert ist. |
encryptionStatus |
Verschlüsselungsstatus von DevicePolicyManager. |
verifyAppsEnabled |
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 ( |
Felder | |
---|---|
devicePosture |
Der Wert des Sicherheitsstatus des Geräts. |
postureDetails[] |
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 ( |
Felder | |
---|---|
securityRisk |
Ein bestimmtes Sicherheitsrisiko, das sich negativ auf den Sicherheitsstatus des Geräts auswirkt. |
advice[] |
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 ( |
Felder | |
---|---|
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 |
Nur Ausgabe Wenn dieses Gerät von einem anderen DPC migriert wurde, ist dies der Paketname. Wird nicht anderweitig ausgefüllt. |
additionalData |
Nur Ausgabe Wenn dieses Gerät von einem anderen DPC migriert wurde, enthält das Feld |
Methoden |
|
---|---|
|
Löscht ein Gerät. |
|
Ein Gerät abrufen. |
|
Gibt einen Befehl an ein Gerät aus. |
|
Listet Geräte für ein bestimmtes Unternehmen auf. |
|
Aktualisiert ein Gerät. |