- Ressource: Gerät
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- DeviceState
- NonComplianceDetail
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- OncWifiContext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PasswordPoliciesContext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SoftwareInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SystemUpdateInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UpdateStatus
- HardwareInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Displaykampagnen
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- DisplayState
- ApplicationReport
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ApplicationEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Schweregrad
- UserFacingType
- NetworkInfo
- TelephonyInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- MemoryInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- MemoryEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- MemoryEventType
- PowerManagementEvent
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PowerManagementEventType
- HardwareStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- DeviceSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- EncryptionStatus
- SecurityPosture
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- DevicePosture
- PostureDetail
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SecurityRisk
- CommonCriteriaModeInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CommonCriteriaModeStatus
- DpcMigrationInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- 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 wirkt sich darauf aus, 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 derzeit auf das Gerät angewendete Status. |
policyCompliant |
Gibt an, ob das Gerät seiner Richtlinie 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 einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
lastStatusReportTime |
Der Zeitpunkt, zu dem das Gerät zuletzt einen Statusbericht gesendet hat. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
lastPolicyComplianceReportTime |
Verworfen. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
lastPolicySyncTime |
Der Zeitpunkt, zu dem das Gerät zuletzt seine Richtlinie abgerufen hat. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
policyName |
Der Name der auf das Gerät angewendeten Richtlinie im Format |
appliedPolicyName |
Der Name der Richtlinie, die derzeit auf das Gerät angewendet wird. |
appliedPolicyVersion |
Die Version der Richtlinie, die derzeit auf dem Gerät angewendet wird. |
apiLevel |
Das API-Level der Android-Plattformversion, die auf dem Gerät ausgeführt wird. |
enrollmentTokenData |
Wenn das Gerät mit einem Registrierungstoken mit zusätzlichen 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 |
Lautet der Gerätestatus |
softwareInfo |
Detaillierte Informationen zur Gerätesoftware Diese Informationen sind nur verfügbar, wenn „ |
hardwareInfo |
Detaillierte Informationen zur Gerätehardware. |
displays[] |
Detaillierte Informationen zu Displays auf dem Gerät. Diese Informationen sind nur verfügbar, wenn „ |
applicationReports[] |
Berichte für auf dem Gerät installierte Apps. Diese Informationen sind nur verfügbar, wenn „ |
previousDeviceNames[] |
Wenn dasselbe physische Gerät mehrmals registriert wurde, enthält dieses Feld die vorherigen Gerätenamen. Die Seriennummer dient als eindeutige Kennung, um festzustellen, ob dasselbe physische Gerät zuvor registriert wurde. Die Namen sind in chronologischer Reihenfolge. |
networkInfo |
Informationen zum Gerätenetzwerk. Diese Informationen sind nur verfügbar, wenn „ |
memoryInfo |
Speicherinformationen: enthält Informationen zum Arbeitsspeicher und zum Speicher des Geräts. |
memoryEvents[] |
Ereignisse im Zusammenhang mit Arbeitsspeicher- und Speichermessungen in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn „ Termine werden für einen bestimmten Zeitraum aufbewahrt und alte Termine werden gelöscht. |
powerManagementEvents[] |
Ereignisse zur Energieverwaltung auf dem Gerät in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn „ |
hardwareStatusSamples[] |
Hardwarestatusbeispiele in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn „ |
deviceSettings |
Informationen zu den Geräteeinstellungen. Diese Informationen sind nur verfügbar, wenn „ |
user |
Der Nutzer, dem das Gerät gehört. |
systemProperties |
Zuordnung des Namens und Werts der ausgewählten Systemeigenschaften, die sich auf das Gerät beziehen. Diese Informationen sind nur verfügbar, wenn „ Ein Objekt, das eine Liste von |
securityPosture |
Der Wert für den 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 in den Common Criteria for Information Technology Security Evaluation (CC) definiert sind. Diese Informationen sind nur verfügbar, wenn „ |
appliedPasswordPolicies[] |
Die aktuell für das Gerät geltenden Passwortanforderungen.
|
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 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 behalten diesen Status, bis 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. Zum Fortsetzen der Migration sind keine weiteren Maßnahmen erforderlich. |
DEACTIVATED_BY_DEVICE_FINANCE |
Dies ist ein finanziertes Gerät, das „gesperrt“ wurde der Finanzierungsmakler. Das bedeutet, dass bestimmte Richtlinieneinstellungen angewendet wurden, die die Funktionalität des Geräts einschränken, bis das Gerät „entsperrt“ wird der Finanzierungsmakler. Auf dem Gerät werden weiterhin Richtlinieneinstellungen angewendet, mit Ausnahme derjenigen, die vom Finanzierungsmitarbeiter überschrieben wurden. Wenn das Gerät „gesperrt“ ist, wird der Status in appliedState als „DEACTIVATED_BY_DEVICE_FINANCE “ gemeldet. |
NonComplianceDetail
Enthält detaillierte Informationen zur Nichteinhaltung einer 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 nicht der Einstellung entspricht. |
packageName |
Der Paketname, der angibt, welche App nicht konform ist (falls zutreffend). |
fieldPath |
Wenn ein bestimmtes verschachteltes Feld nicht konform ist, wird bei Einstellungen mit verschachtelten Feldern der vollständige Pfad zum betreffenden Feld angegeben. Der Pfad ist genauso formatiert, wie das Richtlinien-JSON-Feld in JavaScript referenziert wird, d. h.: 1) Bei Feldern vom Typ „Objekt“ folgt auf den Feldnamen ein Punkt und dann der Name eines Unterfelds. 2) Bei Feldern vom Typ Array folgt auf den Feldnamen der in Klammern eingeschlossene Array-Index. Um beispielsweise auf ein Problem mit dem Feld |
currentValue |
Wenn die Richtlinieneinstellung nicht angewendet werden konnte, den aktuellen 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 eine App nicht installiert werden kann
Enums | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
Dieser Wert ist nicht zulässig. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
Ein unbekannter Zustand verhindert, dass die App installiert werden kann. 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 bei Google Play nicht gefunden. |
NOT_COMPATIBLE_WITH_DEVICE |
Die App ist nicht mit dem Gerät 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 |
Die Installation konnte aufgrund eines Netzwerkfehlers auf dem Nutzergerät nicht abgeschlossen werden. Das passiert in der Regel, wenn die Internetverbindung des Geräts beeinträchtigt oder nicht verfügbar ist oder wenn ein Problem mit der Netzwerkkonfiguration vorliegt. Achten Sie darauf, dass das Gerät Zugriff auf eine vollständige 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. Sobald auf dem Gerät genügend Speicherplatz vorhanden ist, wird die App-Installation oder das App-Update automatisch fortgesetzt. |
SpecificNonComplianceReason
Weitere Details zu den Gründen, aus denen ein Gerät möglicherweise einer Richtlinieneinstellung nicht entspricht. Zukünftig können neue Werte zur Aufzählung hinzugefügt werden.
Enums | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
Es wurde kein genauer Grund für die Nichteinhaltung angegeben. Die Felder in sind nicht festgelegt. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
Der Nutzer muss die Anmeldedaten bestätigen, indem er die Displaysperre eingibt. Die Felder in sind nicht festgelegt. ist auf gesetzt. |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
Das Passwort für das Gerät oder das Profil ist abgelaufen. ist festgelegt. ist auf gesetzt. |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
Das Gerätepasswort erfüllt nicht die Passwortanforderungen. ist festgelegt. ist auf gesetzt. |
ONC_WIFI_INVALID_VALUE |
In der ONC-WLAN-Konfiguration ist ein falscher Wert angegeben. gibt an, welcher Feldwert falsch ist. ist festgelegt. ist auf gesetzt. |
ONC_WIFI_API_LEVEL |
Die ONC-WLAN-Einstellung wird auf der API-Ebene 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 WLAN des Unternehmens 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 angegebene Schlüsselpaarname in 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 für Richtlinienverstöße im Zusammenhang mit der WLAN-Konfiguration. Weitere Informationen: |
passwordPoliciesContext |
Zusätzlicher Kontext zu Nichteinhaltung der Passwortrichtlinien. Weitere Informationen finden Sie unter |
OncWifiContext
Zusätzlicher Kontext für Richtlinienverstöße im Zusammenhang mit der WLAN-Konfiguration.
JSON-Darstellung |
---|
{ "wifiGuid": string } |
Felder | |
---|---|
wifiGuid |
Die GUID der nicht konformen WLAN-Konfiguration. |
PasswordPoliciesContext
Zusätzlicher Kontext zu Nichteinhaltung der Passwortrichtlinien.
JSON-Darstellung |
---|
{
"passwordPolicyScope": enum ( |
Felder | |
---|---|
passwordPolicyScope |
Der Geltungsbereich 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 Android-Versionsstring. 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 Bootloaders, z.B. |
androidBuildTime |
Build-Zeit. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 potenziell ausstehenden Systemupdate. |
SystemUpdateInfo
Informationen zu einem potenziell ausstehenden Systemupdate.
JSON-Darstellung |
---|
{
"updateStatus": enum ( |
Felder | |
---|---|
updateStatus |
Der Status eines Updates: Gibt an, ob und um welchen Typ 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 einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
UpdateStatus
Der Status eines Updates: Gibt an, ob und um welchen Typ es sich handelt.
Enums | |
---|---|
UPDATE_STATUS_UNKNOWN |
Es ist nicht bekannt, ob ein Systemupdate aussteht. Dies ist beispielsweise der Fall, wenn das API-Level des Geräts kleiner als 26 ist oder die Version der Android Device Policy veraltet ist. |
UP_TO_DATE |
Auf dem Gerät ist kein ausstehendes Systemupdate verfügbar. |
UNKNOWN_UPDATE_AVAILABLE |
Ein ausstehendes Systemupdate ist verfügbar, ihr Typ ist jedoch unbekannt. |
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 Richtlinie des Geräts „hardwareStatusEnabled
“ 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 } |
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[] |
Temperaturgrenzwerte für das Ausschalten des Akkus in Celsius für jeden Akku des Geräts. |
batteryThrottlingTemperatures[] |
Temperaturgrenzwerte für die Akkudrosselung in Celsius für jeden Akku des Geräts. |
cpuShutdownTemperatures[] |
Grenzwerte für die CPU-Herunterfahren-Temperatur in Celsius für jede CPU auf dem Gerät. |
cpuThrottlingTemperatures[] |
Die Grenzwerte für die CPU-Drosselung in Celsius für jede CPU auf dem Gerät. |
gpuShutdownTemperatures[] |
Temperaturgrenzwerte für das Herunterfahren der GPU in Celsius für jede GPU auf dem Gerät. |
gpuThrottlingTemperatures[] |
GPU-Drosselung der Temperaturgrenzwerte in Celsius für jede GPU auf dem Gerät. |
skinShutdownTemperatures[] |
Temperaturgrenzwerte für das Ausschalten der Haut des Geräts in Celsius. |
skinThrottlingTemperatures[] |
Grenzwerte für die Hauttemperatur des Geräts in Celsius. |
enterpriseSpecificId |
Nur Ausgabe. Die ID, die ein privates Gerät in einer bestimmten Organisation eindeutig identifiziert. Wenn Sie dasselbe physische Gerät in derselben Organisation registrieren, bleibt diese ID über alle Einrichtungen hinweg und auch über das Zurücksetzen auf die Werkseinstellungen hinweg bestehen. Diese ID ist auf privaten Geräten mit einem Arbeitsprofil auf Geräten mit Android 12 und höher verfügbar. |
Display
Informationen zum Gerätedisplay.
JSON-Darstellung |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Felder | |
---|---|
name |
Name des Displays. |
displayId |
Eindeutige Display-ID. |
refreshRate |
Aktualisierungsrate des Displays in Bildern pro Sekunde |
state |
Status des Bildschirms. |
width |
Anzeigebreite in Pixeln. |
height |
Anzeigehöhe in Pixeln. |
density |
Kompaktheitsgrad 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 stürzt bei geringem Energieverbrauch ab |
SUSPENDED |
Das Display stürzt im Ruhemodus. |
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 App-Versionscode, 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 |
Der SHA-256-Hash der APK-Datei der App, mit der überprüft werden kann, ob die App geändert wurde. Jedes Byte des Hashwerts wird als zweistellige Hexadezimalzahl dargestellt. |
signingKeyCertFingerprints[] |
Der SHA-1-Hash-Wert jedes |
installerPackageName |
Der Paketname der App, über die diese App installiert wurde. |
applicationSource |
Die Quelle des Pakets. |
state |
Anwendungsstatus. |
keyedAppStates[] |
Liste der von der App gemeldeten verschlüsselten App-Status. |
userFacingType |
Gibt an, ob die App für den Nutzer sichtbar ist. |
ApplicationEvent
Ein App-bezogenes Ereignis.
JSON-Darstellung |
---|
{
"eventType": enum ( |
Felder | |
---|---|
eventType |
App-Ereignistyp. |
createTime |
Die Erstellungszeit des Ereignisses. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
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 Anwendung wurde geändert, z. B. wenn eine Komponente aktiviert oder deaktiviert wurde. |
DATA_CLEARED |
Die App-Daten wurden gelöscht. |
REMOVED |
Die App wurde entfernt. |
REPLACED |
Die alte Version der App wurde durch eine neue 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 werkseitigen Abbild 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 |
App-Status ist nicht angegeben |
REMOVED |
Die App wurde vom Gerät entfernt |
INSTALLED |
App ist auf dem Gerät installiert |
KeyedAppState
Der von der App gemeldete schlüsselbasierte App-Status.
JSON-Darstellung |
---|
{
"key": string,
"severity": enum ( |
Felder | |
---|---|
key |
Der Schlüssel für den App-Status. Sie dient als Bezugspunkt für den Zustand der App. Wenn Sie beispielsweise Feedback zur verwalteten Konfiguration geben, kann dieser Schlüssel der Schlüssel für die verwaltete Konfiguration sein. |
severity |
Der Schweregrad des Anwendungsstatus. |
message |
Optional ein Nachrichtenstring im freien Format zur Erläuterung des Anwendungsstatus. Wenn der Status durch einen bestimmten Wert ausgelöst wurde (z.B. einen Wert für eine verwaltete Konfiguration), sollte dieser in der Nachricht enthalten sein. |
data |
Optional ein maschinenlesbarer Wert, der vom EMM gelesen werden soll. Legen Sie beispielsweise Werte fest, die der Administrator in der EMM-Konsole abfragen kann (z.B. „Ich möchte benachrichtigt werden, wenn die Daten vom Typ „battery_warning“ < 10 sind“). |
createTime |
Der Erstellungszeitpunkt des App-Status auf dem Gerät. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
lastUpdateTime |
Der Zeitpunkt, zu dem der App-Status zuletzt aktualisiert wurde. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
Schweregrad
Der Schweregrad des Anwendungsstatus.
Enums | |
---|---|
SEVERITY_UNSPECIFIED |
Unbekannter Schweregrad. |
INFO |
Schweregrad der Informationen. |
ERROR |
Schweregrad der Fehler. Diese Einstellung sollte nur für echte Fehlerbedingungen festgelegt werden, die von der Verwaltungsorganisation behoben werden müssen. |
UserFacingType
Gibt an, ob die App für den Nutzer sichtbar ist.
Enums | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
Der für den Nutzer sichtbare Typ der App ist nicht angegeben. |
NOT_USER_FACING |
Die App ist nicht für Nutzer sichtbar. |
USER_FACING |
Die App ist für den Nutzer sichtbar. |
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 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 einer bestimmten SIM-Karte auf dem Gerät zugeordnet 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 dieser SIM-Karte zugeordnet ist |
MemoryInfo
Informationen zum Arbeitsspeicher und Speicherplatz des Geräts.
JSON-Darstellung |
---|
{ "totalRam": string, "totalInternalStorage": string } |
Felder | |
---|---|
totalRam |
RAM auf dem Gerät insgesamt in Byte. |
totalInternalStorage |
Interner Speicher auf dem Gerät insgesamt in Byte. |
MemoryEvent
Ein Ereignis im Zusammenhang mit Arbeitsspeicher- und Speichermessungen.
Zur Unterscheidung zwischen neuen und alten Ereignissen empfehlen wir die Verwendung des Felds
.createTime
JSON-Darstellung |
---|
{
"eventType": enum ( |
Felder | |
---|---|
eventType |
Ereignistyp |
createTime |
Die Erstellungszeit des Ereignisses. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
byteCount |
Die Anzahl der kostenlosen 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 RAM-Speicherplatz 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 in einem externen Speichermedium wurde gemessen. |
PowerManagementEvent
Ein Ereignis zur Energieverwaltung.
JSON-Darstellung |
---|
{
"eventType": enum ( |
Felder | |
---|---|
eventType |
Ereignistyp |
createTime |
Die Erstellungszeit des Ereignisses. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
batteryLevel |
Für |
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 |
Das Gerät wird nicht mehr aufgeladen. |
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 ermitteln.
JSON-Darstellung |
---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
Felder | |
---|---|
createTime |
Der Zeitpunkt, zu dem die Messungen vorgenommen wurden. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
batteryTemperatures[] |
Aktuelle Akkutemperaturen in Celsius für jeden Akku des Geräts. |
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[] |
Die Lüftergeschwindigkeit in RPM für jeden Lüfter des Geräts. Ein leeres Array bedeutet, dass keine Lüfter vorhanden sind oder die Lüftergeschwindigkeit vom System nicht unterstützt wird. |
cpuUsages[] |
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 vom System nicht unterstützt wird. |
DeviceSettings
Informationen zu sicherheitsbezogenen 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 geschützt wird. |
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 Dieser Typ sollte auf keinem Gerät festgelegt werden. |
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 mit dem Nutzerprofil verknüpft. |
SecurityPosture
Der Sicherheitsstatus des Geräts, bestimmt anhand des aktuellen Gerätestatus und der angewendeten Richtlinien.
JSON-Darstellung |
---|
{ "devicePosture": enum ( |
Felder | |
---|---|
devicePosture |
Wert für den Sicherheitsstatus des Geräts. |
postureDetails[] |
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 es für die Verwendung mit Unternehmensdaten empfohlen wird. |
POTENTIALLY_COMPROMISED |
Dieses Gerät könnte gehackt worden sein und nicht autorisierte Personen auf Unternehmensdaten zugreifen. |
PostureDetail
Zusätzliche Details zum Sicherheitsstatus des Geräts.
JSON-Darstellung |
---|
{ "securityRisk": enum ( |
Felder | |
---|---|
securityRisk |
Ein spezifisches Sicherheitsrisiko, das sich negativ auf den Sicherheitsstatus des Geräts auswirkt. |
advice[] |
Entsprechende Empfehlungen von Administratoren, um dieses Sicherheitsrisiko zu minimieren und den Sicherheitsstatus des Geräts zu verbessern |
SecurityRisk
Das Risiko, durch das 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. Die BasicIntegrity-Prüfung ist zwar erfolgreich, „ctsProfileMatch“ schlägt jedoch 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 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 in den Common Criteria for Information Technology Security Evaluation (CC) definiert sind.
Diese Informationen sind nur verfügbar, wenn statusReportingSettings.commonCriteriaModeEnabled
in den Geräterichtlinien true
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 dazu, ob dieses Gerät von einem 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. Andernfalls wird dieses Feld nicht 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 abruft. |
|
Gibt einen Befehl an ein Gerät aus. |
|
Listet die Geräte für ein bestimmtes Unternehmen auf. |
|
Ein Gerät wird aktualisiert. |