- Ressource: Gerät
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- EuiccChipInfo
- Display
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Schweregrad
- UserFacingType
- NetworkInfo
- TelephonyInfo
- ActivationState
- ConfigMode
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- PolicySignatureVerificationStatus
- 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 nicht von enterprises.devices.patch
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 Verwaltungstyp, den die Android Device Policy auf dem Gerät übernimmt. Dies 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 Patch-Anfrage geändert werden. Beachten Sie, dass beim Aufrufen von |
appliedState |
Der Status, der derzeit auf das Gerät angewendet wird. |
policyCompliant |
Gibt an, ob das Gerät der Richtlinie entspricht. |
nonComplianceDetails[] |
Details zu Richtlinieneinstellungen, die auf dem Gerät nicht eingehalten werden. |
enrollmentTime |
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: |
lastStatusReportTime |
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: |
lastPolicyComplianceReportTime |
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: |
lastPolicySyncTime |
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: |
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 das 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 |
Wenn 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 den 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 wird als eindeutige Kennung verwendet, um festzustellen, ob dasselbe physische Gerät bereits registriert wurde. Die Namen sind in chronologischer Reihenfolge aufgeführt. |
networkInfo |
Informationen zum Gerätenetzwerk. Diese Informationen sind nur verfügbar, wenn |
memoryInfo |
Arbeitsspeicherinformationen: Enthält Informationen zum Arbeitsspeicher und Speicherplatz des Geräts. |
memoryEvents[] |
Ereignisse im Zusammenhang mit Arbeitsspeicher- und Speichermessungen in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn Ereignisse werden für einen bestimmten Zeitraum aufbewahrt und alte Ereignisse werden gelöscht. |
powerManagementEvents[] |
Ereignisse zur Energieverwaltung auf dem Gerät in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn |
hardwareStatusSamples[] |
Beispiele für den Hardwarestatus in chronologischer Reihenfolge. Diese Informationen sind nur verfügbar, wenn |
deviceSettings |
Informationen zu Geräteeinstellungen. Diese Informationen sind nur verfügbar, wenn |
user |
Der Nutzer, dem das Gerät gehört. |
systemProperties |
Eine Zuordnung von Namen und Werten ausgewählter Systemeigenschaften, die sich auf das Gerät beziehen. Diese Informationen sind nur verfügbar, wenn Ein Objekt, das eine Liste von |
securityPosture |
Wert für die Sicherheitslage des Geräts, der angibt, wie sicher das Gerät ist. |
ownership |
Eigentümerschaft 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 Passwortanforderungen, die derzeit auf das Gerät angewendet werden.
|
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 ( |
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 App, die nicht den Richtlinien entspricht, falls zutreffend. |
fieldPath |
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 |
currentValue |
Wenn die Richtlinieneinstellung nicht angewendet werden konnte, wird der aktuelle Wert der Einstellung auf dem Gerät angezeigt. |
installationFailureReason |
Wenn |
specificNonComplianceReason |
Der richtlinienspezifische Grund, warum das Gerät nicht der Einstellung entspricht. |
specificNonComplianceContext |
Zusätzlicher Kontext für |
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 |
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 sind nicht festgelegt. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
Der Nutzer muss die Anmeldedaten bestätigen, indem er die Displaysperre eingibt. 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 erfüllt nicht die Passwortanforderungen. ist festgelegt. ist auf gesetzt. |
ONC_WIFI_INVALID_VALUE |
In der ONC-WLAN-Konfiguration ist ein falscher Wert enthalten. gibt an, welcher Feldwert falsch ist. ist festgelegt. ist auf 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. gibt an, welcher Feldwert nicht unterstützt wird. ist festgelegt. ist auf gesetzt. |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Im WLAN-Netzwerk des Unternehmens fehlen 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 über das Feld ClientCertKeyPairAlias in angegebene Alias für das Schlüsselpaar entspricht keinem auf dem Gerät installierten Schlüssel. ist auf 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. ist auf gesetzt. |
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE |
Das Arbeitskonto, das für die Richtlinieneinstellung „ “ erforderlich ist, gehört nicht mehr zum Unternehmen. ist auf gesetzt. |
NEW_ACCOUNT_NOT_IN_ENTERPRISE |
Das vom Nutzer hinzugefügte Arbeitskonto gehört nicht zum Unternehmen. ist auf gesetzt. |
SpecificNonComplianceContext
Zusätzlicher Kontext für
.SpecificNonComplianceReason
JSON-Darstellung |
---|
{ "oncWifiContext": { object ( |
Felder | |
---|---|
oncWifiContext |
Zusätzlicher Kontext für die Nichteinhaltung von Richtlinien in Bezug auf die WLAN-Konfiguration. Weitere Informationen finden Sie unter |
passwordPoliciesContext |
Zusätzlicher Kontext für die Nichteinhaltung von Passwortrichtlinien. Weitere Informationen finden Sie unter |
OncWifiContext
Zusätzlicher Kontext für die Nichteinhaltung von Richtlinien in Bezug auf die WLAN-Konfiguration.
JSON-Darstellung |
---|
{ "wifiGuid": string } |
Felder | |
---|---|
wifiGuid |
Die GUID der nicht konformen WLAN-Konfiguration. |
PasswordPoliciesContext
Zusätzlicher Kontext für die Nichteinhaltung von Passwortrichtlinien.
JSON-Darstellung |
---|
{
"passwordPolicyScope": enum ( |
Felder | |
---|---|
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 ( |
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, die dem Nutzer angezeigt wird. |
androidBuildNumber |
Die Android-Build-ID-String, die dem Nutzer angezeigt werden soll. Beispiel: |
deviceKernelVersion |
Kernel-Version, z. B. |
bootloaderVersion |
Die Versionsnummer des System-Bootloaders, z.B. |
androidBuildTime |
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: |
securityPatchLevel |
Sicherheitspatch-Level, z.B. |
primaryLanguageCode |
Ein Sprachcode nach IETF BCP 47 für das primäre Gebietsschema 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: ob ein Update vorhanden ist und welcher Art es ist. |
updateReceivedTime |
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. 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: |
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 ( |
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[] |
Temperaturschwellen für das Herunterfahren des Akkus in Grad Celsius für jeden Akku auf dem Gerät. |
batteryThrottlingTemperatures[] |
Temperaturschwellen für die Akku-Drosselung in Grad Celsius für jeden Akku auf dem Gerät. |
cpuShutdownTemperatures[] |
CPU-Abschalttemperaturschwellenwerte in Grad Celsius für jede CPU auf dem Gerät. |
cpuThrottlingTemperatures[] |
Temperaturschwellen für die CPU-Drosselung in Grad Celsius für jede CPU auf dem Gerät. |
gpuShutdownTemperatures[] |
GPU-Abschalttemperaturschwellenwerte in Grad Celsius für jede GPU auf dem Gerät. |
gpuThrottlingTemperatures[] |
Temperaturschwellen für die GPU-Drosselung in Grad Celsius für jede GPU auf dem Gerät. |
skinShutdownTemperatures[] |
Grenzwerte für die Abschaltung des Geräts aufgrund der Hauttemperatur in Grad Celsius. |
skinThrottlingTemperatures[] |
Grenzwerte für die Drosselung der Hauttemperatur des Geräts in Grad Celsius. |
enterpriseSpecificId |
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[] |
Nur Ausgabe. Informationen zum eUICC-Chip. |
EuiccChipInfo
Informationen zum eUICC-Chip.
JSON-Darstellung |
---|
{ "eid": string } |
Felder | |
---|---|
eid |
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 ( |
Felder | |
---|---|
name |
Name des Displays. |
displayId |
Eindeutige Display-ID. |
refreshRate |
Aktualisierungsrate des Displays in Bildern pro Sekunde. |
state |
Status des Displays. |
width |
Breite des Displays in Pixeln. |
height |
Höhe des Displays in Pixeln. |
density |
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 ( |
Felder | |
---|---|
packageName |
Paketname der App |
versionName |
Die App-Version, die dem Nutzer angezeigt wird. |
versionCode |
Der App-Versionscode, mit dem sich feststellen lässt, ob eine Version neuer als eine andere ist. |
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 dem überprü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 |
Der Paketname der App, über die diese App installiert wurde. |
applicationSource |
Die Quelle des Pakets. |
state |
Anwendungsstatus. |
keyedAppStates[] |
Liste der von der App gemeldeten App-Zustände mit Schlüssel. |
userFacingType |
Gibt an, ob die App für Nutzer bestimmt ist. |
ApplicationEvent
Ein App-bezogenes Ereignis.
JSON-Darstellung |
---|
{
"eventType": enum ( |
Felder | |
---|---|
eventType |
App-Ereignistyp. |
createTime |
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: |
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 ( |
Felder | |
---|---|
key |
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 |
Der Schweregrad des App-Status. |
message |
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 |
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 |
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: |
lastUpdateTime |
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: |
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 ( |
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. Zum 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 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 ( |
Felder | |
---|---|
phoneNumber |
Die mit dieser SIM-Karte verknüpfte Telefonnummer. |
carrierName |
Der Name des Mobilfunkanbieters, der mit dieser SIM-Karte verknüpft ist. |
iccId |
Nur Ausgabe. Die ICCID, die mit dieser SIM-Karte verknüpft ist. |
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 |
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 |
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 |
Gesamter RAM auf dem Gerät in Byte. |
totalInternalStorage |
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 ( |
Felder | |
---|---|
eventType |
Ereignistyp |
createTime |
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: |
byteCount |
Die Anzahl der kostenlosen Byte auf dem Medium oder für |
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 ( |
Felder | |
---|---|
eventType |
Ereignistyp |
createTime |
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: |
batteryLevel |
Für |
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 |
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: |
batteryTemperatures[] |
Aktuelle Akkutemperaturen in Grad Celsius für jeden Akku im Gerät. |
cpuTemperatures[] |
Aktuelle CPU-Temperaturen in Grad Celsius für jede CPU auf dem Gerät. |
gpuTemperatures[] |
Aktuelle GPU-Temperaturen in Grad Celsius für jede GPU auf dem Gerät. |
skinTemperatures[] |
Aktuelle Hauttemperaturen des Geräts in Grad Celsius. |
fanSpeeds[] |
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[] |
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 ( |
Felder | |
---|---|
isDeviceSecure |
Gibt an, ob das Gerät mit einer PIN oder einem Passwort geschützt 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 |
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 ( |
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 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 ( |
Felder | |
---|---|
securityRisk |
Ein bestimmtes Sicherheitsrisiko, das sich negativ auf die Sicherheit des Geräts auswirkt. |
advice[] |
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 ( |
Felder | |
---|---|
commonCriteriaModeStatus |
Gibt an, ob der Common Criteria-Modus aktiviert ist. |
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 „false“ ist. |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
Die Überprüfung der Richtliniensignatur ist auf dem Gerät deaktiviert, da 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 |
Nur Ausgabe. Wenn dieses Gerät von einem anderen Geräteinhaberprofil-Controller migriert wurde, ist dies der Paketname. Andernfalls nicht ausgefüllt. |
additionalData |
Nur Ausgabe. Wenn dieses Gerät von einem anderen DPC migriert wurde, wird das Feld |
Methoden |
|
---|---|
|
Löscht ein Gerät. |
|
Ruft ein Gerät ab. |
|
Gibt einen Befehl an ein Gerät aus. |
|
Listet Geräte für ein bestimmtes Unternehmen auf. |
|
Aktualisiert ein Gerät. |