MCP Tools Reference: Android Device Management MCP Server

Tool: get_device

Ruft Gerätedetails für ein bestimmtes Unternehmen und eine bestimmte Geräte-ID ab. Erfordert den Ressourcennamen im Format „enterprises/{enterpriseId}/devices/{deviceId}“.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_device aufrufen.

Curl-Anfrage 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_device",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfrage zum Erhalten eines Geräts

GetDeviceRequest

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

string

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

Ausgabeschema

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.

Gerät

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

string

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

string

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

enum (ManagementMode)

Der Verwaltungstyp, den die Android Device Policy App auf dem Gerät übernimmt. Dies wirkt sich darauf aus, welche Richtlinieneinstellungen unterstützt werden.
state

enum (DeviceState)

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

enum (DeviceState)

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

boolean

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

object (NonComplianceDetail)

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

string (Timestamp format)

Der Zeitpunkt der Geräteregistrierung.

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

string (Timestamp format)

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

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

string (Timestamp format)

Verworfen.

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

string (Timestamp format)

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

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

string

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

string

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

string (int64 format)

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

integer

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

string

Wenn das Gerät mit einem Registrierungstoken registriert wurde, für das zusätzliche Daten angegeben wurden, enthält dieses Feld diese Daten.
enrollmentTokenName

string

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

object (UserFacingMessage)

Wenn der Gerätestatus DISABLED ist, wird auf dem Gerät eine optionale Meldung angezeigt, in der der Grund für die Deaktivierung des Geräts angegeben ist. Dieses Feld kann durch eine Patch-Anfrage geändert werden.
softwareInfo

object (SoftwareInfo)

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

object (HardwareInfo)

Detaillierte Informationen zur Gerätehardware.
displays[]

object (Display)

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

object (ApplicationReport)

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

string

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

object (NetworkInfo)

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

object (MemoryInfo)

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

object (MemoryEvent)

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

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

object (PowerManagementEvent)

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

object (HardwareStatus)

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

object (DeviceSettings)

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

object (User)

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

map (key: string, value: string)

Eine Zuordnung von Namen und Werten ausgewählter Systemeigenschaften, die sich auf das Gerät beziehen. Diese Informationen sind nur verfügbar, wenn systemPropertiesEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist.

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

object (SecurityPosture)

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

enum (Ownership)

Eigentümerschaft des verwalteten Geräts.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

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

Diese Informationen sind nur verfügbar, wenn statusReportingSettings.commonCriteriaModeEnabled in der Richtlinie des Geräts true ist und das Gerät unternehmenseigen ist.
appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • Dieses Feld ist vorhanden, weil die angewendeten Anforderungen in einigen Fällen geringfügig von den in passwordPolicies angegebenen Anforderungen abweichen können.
  • Dieses Feld enthält keine Informationen zur Passwort-Compliance. Informationen zur Nichteinhaltung finden Sie unter nonComplianceDetails.
  • NonComplianceDetail.fieldPath wird basierend auf passwordPolicies festgelegt, nicht auf Grundlage dieses Felds.
dpcMigrationInfo

object (DpcMigrationInfo)

Nur Ausgabe. Informationen dazu, ob dieses Gerät von einem anderen Device Policy Controller (DPC) migriert wurde.
defaultApplicationInfo[]

object (DefaultApplicationInfo)

Nur Ausgabe. Die Standardanwendungsinformationen für DefaultApplicationType. Diese Informationen sind nur verfügbar, wenn defaultApplicationInfoReportingEnabled in der Richtlinie des Geräts auf „true“ gesetzt ist. Verfügbar ab Android 16.

Alle App-Typen werden auf vollständig verwalteten Geräten gemeldet. Die Typen DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING und DEFAULT_DIALER werden für die Arbeitsprofile auf unternehmenseigenen Geräten mit einem Arbeitsprofil und auf privaten Geräten gemeldet. DEFAULT_WALLET wird auch für unternehmenseigene Geräte mit einem Arbeitsprofil gemeldet, enthält aber nur Informationen zum Arbeitsprofil.

NonComplianceDetail

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

string

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

enum (NonComplianceReason)

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

string

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

string

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

value (Value format)

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

enum (InstallationFailureReason)

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

enum (SpecificNonComplianceReason)

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

object (SpecificNonComplianceContext)

Zusätzlicher Kontext für specific_non_compliance_reason.

Wert

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt einen Nullwert dar.
numberValue

number

Stellt einen Double-Wert dar.
stringValue

string

Stellt einen Stringwert dar.
boolValue

boolean

Stellt einen booleschen Wert dar.
structValue

object (Struct format)

Stellt einen strukturierten Wert dar.
listValue

array (ListValue format)

Stellt eine wiederholte Value dar.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

map (key: string, value: value (Value format))

Ungeordnete Zuordnung von dynamisch typisierten Werten.

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

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederholtes Feld mit dynamisch typisierten Werten.

SpecificNonComplianceContext

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

object (OncWifiContext)

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

object (PasswordPoliciesContext)

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

object (DefaultApplicationContext)

Nur Ausgabe. Zusätzlicher Kontext für die Nichteinhaltung von Richtlinien in Bezug auf Standardanwendungseinstellungen. DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE ansehen.

OncWifiContext

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

string

Die GUID der nicht konformen WLAN-Konfiguration.

PasswordPoliciesContext

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

enum (PasswordPolicyScope)

Der Umfang des nicht konformen Passworts.

DefaultApplicationContext

JSON-Darstellung 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Felder
defaultApplicationScope

enum (DefaultApplicationScope)

Nur Ausgabe. Der Umfang der nicht konformen Standardeinstellung für die Anwendung.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

UserFacingMessage

JSON-Darstellung 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Felder
localizedMessages

map (key: string, value: string)

Eine Karte mit <locale, message>-Paaren, wobei „locale“ ein wohlgeformter BCP 47-Sprachcode wie „en-US“, „es-ES“ oder „fr“ ist.

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

string

Die Standardnachricht, die angezeigt wird, wenn keine lokalisierte Nachricht angegeben ist oder das Gebietsschema des Nutzers mit keiner der lokalisierten Nachrichten übereinstimmt. Wenn lokalisierte Meldungen angegeben werden, muss eine Standardmeldung angegeben werden.

LocalizedMessagesEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

SoftwareInfo

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

string

Der für den Nutzer sichtbare Android-Versionsstring. Beispiel: 6.0.1.
androidDevicePolicyVersionCode

integer

Der Versionscode der Android Device Policy App.
androidDevicePolicyVersionName

string

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

string

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

string

Kernelversion, z. B. 2.6.32.9-g103d848.
bootloaderVersion

string

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

string (Timestamp format)

Build-Dauer

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

string

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

string

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

string

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

object (SystemUpdateInfo)

Informationen zu einem potenziell ausstehenden Systemupdate.

SystemUpdateInfo

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

enum (UpdateStatus)

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

string (Timestamp format)

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

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

HardwareInfo

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

string

Marke des Geräts. Beispiel: Google.
hardware

string

Name der Hardware. Beispiel: Angler.
deviceBasebandVersion

string

Baseband-Version Beispiel: MDM9625_104662.22.05.34p.
manufacturer

string

Hersteller Beispiel: Motorola.
serialNumber

string

Die Seriennummer des Geräts. Bei privaten Geräten mit Android 12 und höher entspricht dies jedoch der enterpriseSpecificId.
model

string

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

number

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

number

Temperaturschwellenwerte für die Akku-Drosselung in Grad Celsius für jeden Akku auf dem Gerät.
cpuShutdownTemperatures[]

number

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

number

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

number

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

number

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

number

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

number

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

string

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

object (EuiccChipInfo)

Nur Ausgabe. Informationen zum eUICC-Chip.

EuiccChipInfo

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

string

Nur Ausgabe. Die EID (Embedded Identity Document), die den eUICC-Chip für jeden eUICC-Chip auf dem Gerät identifiziert. Diese Funktion ist auf unternehmenseigenen Geräten mit Android 13 und höher verfügbar.

Display

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

string

Name des Displays.
displayId

integer

Eindeutige Display-ID.
refreshRate

integer

Aktualisierungsrate des Displays in Bildern pro Sekunde.
state

enum (DisplayState)

Status der Anzeige.
width

integer

Breite des Displays in Pixeln.
height

integer

Höhe des Displays in Pixeln.
density

integer

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

ApplicationReport

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

string

Paketname der App
versionName

string

Die App-Version, die dem Nutzer angezeigt wird.
versionCode

integer

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

object (ApplicationEvent)

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

string

Der Anzeigename der App.
packageSha256Hash

string

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

string

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

string

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

enum (ApplicationSource)

Die Quelle des Pakets.
state

enum (ApplicationState)

Anwendungsstatus.
keyedAppStates[]

object (KeyedAppState)

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

enum (UserFacingType)

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

ApplicationEvent

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

enum (ApplicationEventType)

App-Ereignistyp.
createTime

string (Timestamp format)

Die Erstellungszeit des Ereignisses.

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

KeyedAppState

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

string

Der Schlüssel für den App-Status. Dient als Referenzpunkt für den Status, den die App bereitstellt. Wenn Sie beispielsweise Feedback zur verwalteten Konfiguration geben, kann dieser Schlüssel der Schlüssel für die verwaltete Konfiguration sein.
severity

enum (Severity)

Der Schweregrad des App-Status.
message

string

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

string

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

NetworkInfo

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

string

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

string

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

string

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

string

Alphabetischer Name des aktuell registrierten Mobilfunkanbieters. Zum Beispiel Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Stellt Telefonieinformationen für jede SIM-Karte auf dem Gerät bereit. Wird nur auf vollständig verwalteten Geräten ab Android-API-Level 23 unterstützt.

TelephonyInfo

JSON-Darstellung 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Felder
phoneNumber

string

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

string

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

string

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

enum (ActivationState)

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

enum (ConfigMode)

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

MemoryInfo

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

string (int64 format)

Gesamter RAM auf dem Gerät in Byte.
totalInternalStorage

string (int64 format)

Gesamter interner Speicher auf dem Gerät in Byte.

MemoryEvent

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

enum (MemoryEventType)

Ereignistyp
createTime

string (Timestamp format)

Die Erstellungszeit des Ereignisses.

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

string (int64 format)

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

PowerManagementEvent

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

enum (PowerManagementEventType)

Ereignistyp
createTime

string (Timestamp format)

Die Erstellungszeit des Ereignisses.

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

number

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

HardwareStatus

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

string (Timestamp format)

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

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

number

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

number

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

number

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

number

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

number

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

number

CPU-Nutzung in Prozent für jeden auf dem Gerät verfügbaren Kern. Die Nutzung ist für jeden nicht angeschlossenen Kern 0. Ein leeres Array bedeutet, dass die CPU-Nutzung im System nicht unterstützt wird.

DeviceSettings

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

boolean

Gibt an, ob das Gerät mit einer PIN oder einem Passwort geschützt ist.
unknownSourcesEnabled

boolean

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

boolean

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

boolean

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

boolean

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

enum (EncryptionStatus)

Verschlüsselungsstatus von DevicePolicyManager.
verifyAppsEnabled

boolean

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

Nutzer

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

string

Eine eindeutige Kennung, die Sie für diesen Nutzer erstellen, z. B. user342 oder asset#44418. Dieses Feld muss beim Erstellen des Nutzers festgelegt werden und kann nicht aktualisiert werden. Dieses Feld darf keine personenidentifizierbaren Informationen enthalten. Diese Kennung darf maximal 1.024 Zeichen lang sein. Andernfalls schlägt die Anfrage zur Aktualisierung der Richtlinie fehl.

SystemPropertiesEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

SecurityPosture

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

enum (DevicePosture)

Wert für den Sicherheitsstatus des Geräts.
postureDetails[]

object (PostureDetail)

Zusätzliche Details zum Sicherheitsstatus des Geräts.

PostureDetail

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

enum (SecurityRisk)

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

object (UserFacingMessage)

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

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

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

enum (PolicySignatureVerificationStatus)

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

PasswordRequirements

JSON-Darstellung 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
Felder
passwordMinimumLength

integer

Die zulässige Mindestlänge des Passworts. Ein Wert von 0 bedeutet, dass es keine Einschränkung gibt. Wird nur erzwungen, wenn password_quality NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC oder COMPLEX ist.
passwordMinimumLetters

integer

Mindestanzahl der Buchstaben, die im Passwort erforderlich sind. Wird nur erzwungen, wenn password_quality COMPLEX ist.
passwordMinimumLowerCase

integer

Mindestanzahl an Kleinbuchstaben, die im Passwort erforderlich sind. Wird nur erzwungen, wenn password_quality COMPLEX ist.
passwordMinimumNonLetter

integer

Mindestanzahl an Zeichen, die keine Buchstaben sind (Ziffern oder Symbole), die im Passwort erforderlich sind. Wird nur erzwungen, wenn password_quality COMPLEX ist.
passwordMinimumNumeric

integer

Mindestanzahl der numerischen Ziffern, die im Passwort erforderlich sind. Wird nur erzwungen, wenn password_quality COMPLEX ist.
passwordMinimumSymbols

integer

Mindestanzahl der im Passwort erforderlichen Symbole. Wird nur erzwungen, wenn password_quality COMPLEX ist.
passwordMinimumUpperCase

integer

Mindestanzahl der Großbuchstaben, die im Passwort erforderlich sind. Wird nur erzwungen, wenn password_quality COMPLEX ist.
passwordQuality

enum (PasswordQuality)

Die erforderliche Passwortqualität.
passwordHistoryLength

integer

Die Länge des Passwortverlaufs. Nachdem dieses Feld festgelegt wurde, kann der Nutzer kein neues Passwort eingeben, das mit einem Passwort im Verlauf identisch ist. Ein Wert von 0 bedeutet, dass es keine Einschränkung gibt.
maximumFailedPasswordsForWipe

integer

Anzahl falscher Passwörter zum Entsperren des Geräts, die eingegeben werden können, bevor die Daten auf dem Gerät gelöscht werden. Ein Wert von 0 bedeutet, dass es keine Einschränkung gibt.
passwordExpirationTimeout

string (Duration format)

Zeitlimit für den Ablauf des Passworts.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
passwordScope

enum (PasswordPolicyScope)

Der Bereich, für den die Passwortanforderung gilt.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Die Zeitspanne, nach der ein Gerät oder Arbeitsprofil, das mit einer starken Authentifizierungsmethode (Passwort, PIN, Muster) entsperrt wurde, mit einer beliebigen anderen Authentifizierungsmethode (z.B. Fingerabdruck, Trust Agents, Gesicht) entsperrt werden kann. Nach Ablauf des angegebenen Zeitraums können nur starke Authentifizierungsmethoden zum Entsperren des Geräts oder Arbeitsprofils verwendet werden.
unifiedLockSettings

enum (UnifiedLockSettings)

Hiermit wird festgelegt, ob auf Geräten mit Android 9 und höher mit einem Arbeitsprofil eine einheitliche Sperre für das Gerät und das Arbeitsprofil zulässig ist. Kann nur festgelegt werden, wenn password_scope auf SCOPE_PROFILE gesetzt ist. Andernfalls wird die Richtlinie abgelehnt. Wenn der Nutzer keine separate Arbeitsprofilsperre eingerichtet hat und dieses Feld auf REQUIRE_SEPARATE_WORK_LOCK gesetzt ist, wird ein NonComplianceDetail mit nonComplianceReason auf USER_ACTION gemeldet.

Dauer

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Signierte Sekunden des Zeitraums. Muss zwischen -315.576.000.000 und +315.576.000.000 (einschließlich) liegen. Hinweis: Diese Grenzen werden so berechnet: 60 Sek./Min. × 60 Min./Std. × 24 Std./Tag × 365,25 Tage/Jahr × 10.000 Jahre
nanos

integer

Signierte Sekundenbruchteile mit Nanosekunden-Auflösung für den Zeitraum. Dauern von weniger als einer Sekunde werden mit dem Feld „0“ seconds und einem positiven oder negativen Feld nanos dargestellt. Bei Zeiträumen von einer Sekunde oder mehr muss ein Wert ungleich null für das Feld nanos dasselbe Vorzeichen wie das Feld seconds haben. Muss zwischen -999.999.999 und +999.999.999 liegen (einschließlich).

DpcMigrationInfo

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

string

Nur Ausgabe. Wenn dieses Gerät von einem anderen Geräteinhaber-Controller migriert wurde, ist dies der Paketname. Andernfalls nicht ausgefüllt.
additionalData

string

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

DefaultApplicationInfo

JSON-Darstellung 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Felder
defaultApplicationType

enum (DefaultApplicationType)

Nur Ausgabe. Der Standardanwendungstyp.
packageName

string

Nur Ausgabe. Der Paketname der aktuellen Standardanwendung.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Nur Ausgabe. Details zu den Versuchen, die Standardanwendungseinstellung festzulegen, in derselben Reihenfolge wie in defaultApplications aufgeführt.

DefaultApplicationSettingAttempt

JSON-Darstellung 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Felder
packageName

string

Nur Ausgabe. Der Paketname der versuchten Anwendung.
attemptOutcome

enum (AttemptOutcome)

Nur Ausgabe. Das Ergebnis des Festlegens der App als Standard.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌