MCP Tools Reference: Android Device Management MCP Server

Narzędzie: list_devices

Wyświetla listę urządzeń w danej firmie. Wymaga identyfikatora firmy w polu nadrzędnym (np. enterprises/{enterpriseId}).

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie list_devices MCP.

Żądanie curl 
                  
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": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Prośba o wyświetlenie listy urządzeń w danej firmie.

ListDevicesRequest

Zapis JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Pola
parent

string

Nazwa przedsiębiorstwa w formacie enterprises/{enterpriseId}.
pageSize

integer

Żądany rozmiar strony. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 10 urządzeń. Maksymalna wartość to 100. Wartości powyżej 100 zostaną przekształcone w 100. Limity mogą się z czasem zmieniać.
pageToken

string

Token identyfikujący stronę wyników zwróconych przez serwer.

Schemat wyjściowy

Odpowiedź na żądanie wyświetlenia listy urządzeń w danej firmie.

ListDevicesResponse

Zapis JSON 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
Pola
devices[]

object (Device)

Lista urządzeń.
nextPageToken

string

Jeśli jest więcej wyników, token do pobrania następnej strony wyników.

Urządzenie

Zapis JSON 
{
  "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)
    }
  ]
}
Pola
name

string

Nazwa urządzenia w formacie enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

Nazwa zasobu użytkownika, który jest właścicielem tego urządzenia, w formacie enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Typ trybu zarządzania, który Android Device Policy przyjmuje na urządzeniu. Ma to wpływ na to, które ustawienia zasad są obsługiwane.
state

enum (DeviceState)

Stan, który ma zostać zastosowany na urządzeniu. To pole można modyfikować za pomocą żądania PATCH. Pamiętaj, że podczas wywoływania funkcji enterprises.devices.patch dopuszczalne są tylko wartości ACTIVE i DISABLED. Aby wprowadzić urządzenie w stan DELETED, zadzwoń pod numer enterprises.devices.delete.
appliedState

enum (DeviceState)

Stan obecnie zastosowany na urządzeniu.
policyCompliant

boolean

Wskazuje, czy urządzenie jest zgodne z zasadami.
nonComplianceDetails[]

object (NonComplianceDetail)

Szczegółowe informacje o ustawieniach zasad, z którymi urządzenie nie jest zgodne.
enrollmentTime

string (Timestamp format)

Czas rejestracji urządzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

Ostatni raz, kiedy urządzenie wysłało raport o stanie.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Rola wycofana.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

Ostatni czas pobrania zasad przez urządzenie.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
policyName

string

Nazwa zasady zastosowanej na urządzeniu w formacie enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie zostanie określony, zastosowany zostanie policy_name użytkownika urządzenia. To pole można modyfikować za pomocą żądania PATCH. Podczas wywoływania funkcji enterprises.devices.patch możesz podać tylko policyId, o ile nie zawiera on ukośników.policyId Pozostała część nazwy zasady jest wywnioskowana.
appliedPolicyName

string

Nazwa zasady aktualnie stosowanej na urządzeniu.
appliedPolicyVersion

string (int64 format)

Wersja zasady aktualnie stosowana na urządzeniu.
apiLevel

integer

Poziom interfejsu API wersji platformy Android działającej na urządzeniu.
enrollmentTokenData

string

Jeśli urządzenie zostało zarejestrowane za pomocą tokena rejestracji z dodatkowymi danymi, to pole zawiera te dane.
enrollmentTokenName

string

Jeśli urządzenie zostało zarejestrowane za pomocą tokena rejestracji, to pole zawiera nazwę tokena.
disabledReason

object (UserFacingMessage)

Jeśli stan urządzenia to DISABLED, wyświetlany jest opcjonalny komunikat informujący o przyczynie wyłączenia urządzenia. To pole można modyfikować za pomocą żądania PATCH.
softwareInfo

object (SoftwareInfo)

Szczegółowe informacje o oprogramowaniu urządzenia. Te informacje są dostępne tylko wtedy, gdy zasada softwareInfoEnabled ma wartość Prawda.
hardwareInfo

object (HardwareInfo)

Szczegółowe informacje o sprzęcie urządzenia.
displays[]

object (Display)

Szczegółowe informacje o wyświetlaczach na urządzeniu. Te informacje są dostępne tylko wtedy, gdy zasada displayInfoEnabled ma wartość Prawda.
applicationReports[]

object (ApplicationReport)

Raporty dotyczące aplikacji zainstalowanych na urządzeniu. Te informacje są dostępne tylko wtedy, gdy w zasadach urządzenia wartość parametru application_reports_enabled to „true”.
previousDeviceNames[]

string

Jeśli to samo urządzenie fizyczne zostało zarejestrowane wiele razy, to pole zawiera jego poprzednie nazwy. Numer seryjny jest używany jako unikalny identyfikator, który pozwala określić, czy to samo urządzenie fizyczne zostało wcześniej zarejestrowane. Nazwy są podane w kolejności chronologicznej.
networkInfo

object (NetworkInfo)

Informacje o sieci urządzenia. Te informacje są dostępne tylko wtedy, gdy zasada networkInfoEnabled ma wartość Prawda.
memoryInfo

object (MemoryInfo)

Informacje o pamięci: zawierają informacje o pamięci i miejscu na dane urządzenia.
memoryEvents[]

object (MemoryEvent)

Wydarzenia związane z pomiarami pamięci i miejsca na dane w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy zasada memoryInfoEnabled ma wartość Prawda.

Wydarzenia są przechowywane przez określony czas, a stare wydarzenia są usuwane.
powerManagementEvents[]

object (PowerManagementEvent)

Zdarzenia związane z zarządzaniem energią na urządzeniu w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy zasada powerManagementEventsEnabled ma wartość Prawda.
hardwareStatusSamples[]

object (HardwareStatus)

Próbki stanu sprzętu w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy zasada hardwareStatusEnabled ma wartość Prawda.
deviceSettings

object (DeviceSettings)

Informacje o ustawieniach urządzenia. Te informacje są dostępne tylko wtedy, gdy zasada deviceSettingsEnabled ma wartość Prawda.
user

object (User)

Użytkownik, do którego należy urządzenie.
systemProperties

map (key: string, value: string)

Mapa wybranych nazw i wartości właściwości systemowych związanych z urządzeniem. Te informacje są dostępne tylko wtedy, gdy zasada systemPropertiesEnabled ma wartość Prawda.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
securityPosture

object (SecurityPosture)

Wartość stanu zabezpieczeń urządzenia, która odzwierciedla poziom bezpieczeństwa urządzenia.
ownership

enum (Ownership)

Własność urządzenia zarządzanego.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informacje o trybie Common Criteria – standardach bezpieczeństwa zdefiniowanych w kryteriach Common Criteria dotyczących oceny bezpieczeństwa technologii informacyjnych (CC).

Te informacje są dostępne tylko wtedy, gdy w zasadach urządzenia statusReportingSettings.commonCriteriaModeEnabled ma wartość true, co oznacza, że urządzenie należy do firmy.
appliedPasswordPolicies[]

object (PasswordRequirements)

Wymagania dotyczące haseł, które są obecnie stosowane na urządzeniu.

  • To pole istnieje, ponieważ w niektórych przypadkach zastosowane wymagania mogą się nieznacznie różnić od tych określonych w passwordPolicies.
  • Pamiętaj, że to pole nie zawiera informacji o zgodności hasła z wymaganiami. Informacje o niezgodności znajdziesz w sekcji nonComplianceDetails.
  • NonComplianceDetail.fieldPath jest ustawiana na podstawie passwordPolicies, a nie na podstawie tego pola.
dpcMigrationInfo

object (DpcMigrationInfo)

Tylko dane wyjściowe. Informacje o tym, czy to urządzenie zostało przeniesione z zarządzania przez innego kontrolera zasad dotyczących urządzeń (DPC).
defaultApplicationInfo[]

object (DefaultApplicationInfo)

Tylko dane wyjściowe. Domyślne informacje o aplikacji dla DefaultApplicationType. Te informacje są dostępne tylko wtedy, gdy zasada defaultApplicationInfoReportingEnabled ma wartość Prawda. Dostępne na Androidzie 16 i nowszym.

Na urządzeniach w pełni zarządzanych raportowane są wszystkie typy aplikacji. Typy DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING i DEFAULT_DIALER są zgłaszane w przypadku profili służbowych na urządzeniach należących do firmy z profilem służbowym i na urządzeniach należących do użytkownika. DEFAULT_WALLET jest też raportowany w przypadku urządzeń należących do firmy z profilem służbowym, ale będzie zawierać tylko informacje o profilu służbowym.

NonComplianceDetail

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

string

Nazwa ustawienia zasady. Jest to nazwa pola JSON pola Policy najwyższego poziomu.
nonComplianceReason

enum (NonComplianceReason)

Powód, dla którego urządzenie nie jest zgodne z ustawieniem.
packageName

string

Nazwa pakietu wskazująca, która aplikacja jest niezgodna z zasadami (jeśli dotyczy).
fieldPath

string

W przypadku ustawień z polami zagnieżdżonymi, jeśli określone pole zagnieżdżone jest niezgodne z zasadami, ta wartość określa pełną ścieżkę do pola, które narusza zasady. Ścieżka jest sformatowana w taki sam sposób, w jaki pole JSON zasady byłoby przywoływane w JavaScript: 1) w przypadku pól typu obiekt nazwa pola jest poprzedzona kropką, a następnie nazwą pola podrzędnego. 2) W przypadku pól typu tablicowego po nazwie pola następuje indeks tablicy ujęty w nawiasy. Jeśli na przykład chcesz wskazać problem z polem url w polu externalData w 3 aplikacji, ścieżka będzie wyglądać tak: applications[2].externalData.url
currentValue

value (Value format)

Jeśli ustawienia zasad nie można zastosować, wyświetlana jest bieżąca wartość ustawienia na urządzeniu.
installationFailureReason

enum (InstallationFailureReason)

Jeśli zasada package_name jest skonfigurowana, a powodem niezgodności jest APP_NOT_INSTALLED lub APP_NOT_UPDATED, podawany jest szczegółowy powód, dla którego nie można zainstalować ani zaktualizować aplikacji.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Przyczyna niezgodności urządzenia z ustawieniem.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Dodatkowy kontekst dla specific_non_compliance_reason.

Wartość

Zapis JSON 
{

  // 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.
}
Pola
Pole zbiorcze kind. Rodzaj wartości. kind może mieć tylko jedną z tych wartości:
nullValue

null

Reprezentuje wartość null.
numberValue

number

Reprezentuje wartość typu double.
stringValue

string

Reprezentuje wartość ciągu tekstowego.
boolValue

boolean

Reprezentuje wartość logiczną.
structValue

object (Struct format)

Reprezentuje wartość strukturalną.
listValue

array (ListValue format)

Oznacza powtórzone Value.

Struct

Zapis JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Pola
fields

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

Nieuporządkowana mapa wartości o typie dynamicznym.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

Zapis JSON 
{
  "key": string,
  "value": value
}
Pola
key

string
value

value (Value format)

ListValue

Zapis JSON 
{
  "values": [
    value
  ]
}
Pola
values[]

value (Value format)

Powtórzone pole wartości o dynamicznym typie.

SpecificNonComplianceContext

Zapis JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
Pola
oncWifiContext

object (OncWifiContext)

Dodatkowy kontekst dotyczący niezgodności związanej z konfiguracją Wi-Fi. Zobacz ONC_WIFI_INVALID_VALUE i ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Dodatkowy kontekst dotyczący niezgodności z zasadami dotyczącymi haseł. Zobacz PASSWORD_POLICIES_PASSWORD_EXPIRED i PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.
defaultApplicationContext

object (DefaultApplicationContext)

Tylko dane wyjściowe. Dodatkowy kontekst dotyczący niezgodności związanej z domyślnymi ustawieniami aplikacji. Zobacz DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

Zapis JSON 
{
  "wifiGuid": string
}
Pola
wifiGuid

string

Identyfikator GUID niezgodnej konfiguracji Wi-Fi.

PasswordPoliciesContext

Zapis JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Pola
passwordPolicyScope

enum (PasswordPolicyScope)

Zakres niezgodnego hasła.

DefaultApplicationContext

Zapis JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Pola
defaultApplicationScope

enum (DefaultApplicationScope)

Tylko dane wyjściowe. Zakres ustawienia domyślnej aplikacji niezgodnego z zasadami.

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

UserFacingMessage

Zapis JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Pola
localizedMessages

map (key: string, value: string)

Mapa zawierająca pary <locale, message>, gdzie locale to prawidłowo sformułowany kod języka BCP 47, np. en-US, es-ES lub fr.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultMessage

string

Domyślny komunikat wyświetlany, jeśli nie określono zlokalizowanego komunikatu lub język użytkownika nie pasuje do żadnego z nich. Jeśli podano jakiekolwiek zlokalizowane wiadomości, należy podać domyślną wiadomość.

LocalizedMessagesEntry

Zapis JSON 
{
  "key": string,
  "value": string
}
Pola
key

string
value

string

SoftwareInfo

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

string

Ciąg znaków wersji Androida widoczny dla użytkownika. Na przykład: 6.0.1.
androidDevicePolicyVersionCode

integer

Kod wersji aplikacji Android Device Policy.
androidDevicePolicyVersionName

string

Wersja aplikacji Android Device Policy wyświetlana użytkownikowi.
androidBuildNumber

string

Ciąg identyfikatora kompilacji Androida przeznaczony do wyświetlania użytkownikowi. Na przykład: shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Wersja jądra, np. 2.6.32.9-g103d848.
bootloaderVersion

string

Numer wersji programu rozruchowego systemu, np. 0.6.7.
androidBuildTime

string (Timestamp format)

Czas kompilacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

Poziom aktualizacji zabezpieczeń, np. 2016-05-01.
primaryLanguageCode

string

Kod języka IETF BCP 47 dla podstawowych ustawień regionalnych na urządzeniu.
deviceBuildSignature

string

Identyfikator SHA-256 pliku android.content.pm.Signature powiązanego z pakietem systemowym, który można wykorzystać do sprawdzenia, czy kompilacja systemu nie została zmodyfikowana.
systemUpdateInfo

object (SystemUpdateInfo)

Informacje o potencjalnej oczekującej aktualizacji systemu.

SystemUpdateInfo

Zapis JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Pola
updateStatus

enum (UpdateStatus)

Stan aktualizacji: czy aktualizacja istnieje i jakiego jest typu.
updateReceivedTime

string (Timestamp format)

Czas, w którym aktualizacja była po raz pierwszy dostępna. Wartość 0 oznacza, że to pole nie jest ustawione. To pole jest ustawiane tylko wtedy, gdy jest dostępna aktualizacja (czyli updateStatus nie ma wartości UPDATE_STATUS_UNKNOWN ani UP_TO_DATE).

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

HardwareInfo

Zapis JSON 
{
  "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)
    }
  ]
}
Pola
brand

string

Marka urządzenia. Na przykład: Google.
hardware

string

Nazwa sprzętu. Na przykład: Angler.
deviceBasebandVersion

string

Wersja pasma podstawowego. Na przykład: MDM9625_104662.22.05.34p.
manufacturer

string

Producent. Na przykład: Motorola.
serialNumber

string

Numer seryjny urządzenia. W przypadku urządzeń należących do użytkownika z Androidem 12 lub nowszym jest to jednak to samo co enterpriseSpecificId.
model

string

Model urządzenia. Na przykład: Asus Nexus 7.
batteryShutdownTemperatures[]

number

Progi temperatury wyłączenia baterii w stopniach Celsjusza dla każdej baterii na urządzeniu.
batteryThrottlingTemperatures[]

number

Progi temperatury w stopniach Celsjusza, przy których następuje ograniczenie wydajności baterii na urządzeniu.
cpuShutdownTemperatures[]

number

Progi temperatury wyłączenia procesora w stopniach Celsjusza dla każdego procesora na urządzeniu.
cpuThrottlingTemperatures[]

number

Progi temperatury ograniczania wykorzystania procesora w stopniach Celsjusza dla każdego procesora na urządzeniu.
gpuShutdownTemperatures[]

number

Progi temperatury wyłączenia GPU w stopniach Celsjusza dla każdego GPU na urządzeniu.
gpuThrottlingTemperatures[]

number

Progi temperatury ograniczania wydajności GPU w stopniach Celsjusza dla każdego procesora GPU na urządzeniu.
skinShutdownTemperatures[]

number

Progi temperatury wyłączenia urządzenia w stopniach Celsjusza.
skinThrottlingTemperatures[]

number

Progi temperatury, przy których urządzenie zaczyna ograniczać wydajność, w stopniach Celsjusza.
enterpriseSpecificId

string

Tylko dane wyjściowe. Identyfikator, który w niepowtarzalny sposób identyfikuje urządzenie należące do użytkownika w danej organizacji. Na tym samym urządzeniu fizycznym zarejestrowanym w tej samej organizacji ten identyfikator jest zachowywany w różnych konfiguracjach, a nawet po przywróceniu ustawień fabrycznych. Ten identyfikator jest dostępny na urządzeniach osobistych z profilem służbowym, które działają na Androidzie 12 lub nowszym.
euiccChipInfo[]

object (EuiccChipInfo)

Tylko dane wyjściowe. Informacje związane z chipem eUICC.

EuiccChipInfo

Zapis JSON 
{
  "eid": string
}
Pola
eid

string

Tylko dane wyjściowe. Dokument tożsamości wbudowany (EID), który identyfikuje kartę eUICC dla każdej karty eUICC na urządzeniu. Ta funkcja jest dostępna na urządzeniach należących do firmy z Androidem 13 lub nowszym.

Wyświetlacz

Zapis JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Pola
name

string

Nazwa wyświetlacza.
displayId

integer

Unikalny identyfikator wyświetlenia.
refreshRate

integer

Częstotliwość odświeżania wyświetlacza w klatkach na sekundę.
state

enum (DisplayState)

Stan wyświetlacza.
width

integer

Szerokość wyświetlacza w pikselach.
height

integer

Wysokość wyświetlacza w pikselach.
density

integer

Gęstość wyświetlacza wyrażona w punktach na cal.

ApplicationReport

Zapis JSON 
{
  "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)
}
Pola
packageName

string

Nazwa pakietu aplikacji.
versionName

string

Wersja aplikacji wyświetlana użytkownikowi.
versionCode

integer

Kod wersji aplikacji, który może służyć do określania, czy jedna wersja jest nowsza od drugiej.
events[]

object (ApplicationEvent)

Lista zdarzeń w aplikacji, które miały miejsce w ciągu ostatnich 30 godzin.
displayName

string

Wyświetlana nazwa aplikacji.
packageSha256Hash

string

Hasz SHA-256 pliku APK aplikacji, który można wykorzystać do sprawdzenia, czy aplikacja nie została zmodyfikowana. Każdy bajt wartości skrótu jest reprezentowany jako dwucyfrowa liczba szesnastkowa.
signingKeyCertFingerprints[]

string

Identyfikator SHA-1 każdego android.content.pm.Signature powiązanego z pakietem aplikacji. Każdy bajt każdej wartości skrótu jest reprezentowany jako dwucyfrowa liczba szesnastkowa.
installerPackageName

string

Nazwa pakietu aplikacji, która zainstalowała tę aplikację.
applicationSource

enum (ApplicationSource)

Źródło pakietu.
state

enum (ApplicationState)

Stan aplikacji.
keyedAppStates[]

object (KeyedAppState)

Lista stanów aplikacji z kluczem zgłoszonych przez aplikację.
userFacingType

enum (UserFacingType)

Określa, czy aplikacja jest przeznaczona dla użytkowników.

ApplicationEvent

Zapis JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Pola
eventType

enum (ApplicationEventType)

Typ zdarzenia w aplikacji.
createTime

string (Timestamp format)

Czas utworzenia wydarzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

KeyedAppState

Zapis JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Pola
key

string

Klucz stanu aplikacji. Służy jako punkt odniesienia dla stanu, który zapewnia aplikacja. Na przykład podczas przekazywania opinii o konfiguracji zarządzanej ten klucz może być kluczem konfiguracji zarządzanej.
severity

enum (Severity)

Poziom ważności stanu aplikacji.
message

string

Opcjonalny ciąg znaków z dowolną wiadomością wyjaśniającą stan aplikacji. Jeśli stan został wywołany przez konkretną wartość (np. wartość konfiguracji zarządzanej), należy ją uwzględnić w wiadomości.
data

string

Opcjonalnie wartość odczytywana przez system EMM. Na przykład ustawianie wartości, na podstawie których administrator może wysyłać zapytania w konsoli EMM (np. „powiadom mnie, jeśli dane battery_warning < 10”).
createTime

string (Timestamp format)

Czas utworzenia stanu aplikacji na urządzeniu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

Czas ostatniej aktualizacji stanu aplikacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

NetworkInfo

Zapis JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Pola
imei

string

Numer IMEI urządzenia GSM. Na przykład: A1000031212.
meid

string

Numer MEID urządzenia CDMA. Na przykład: A00000292788E1.
wifiMacAddress

string

Adres MAC sieci Wi-Fi urządzenia. Na przykład: 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Alfabetyczna nazwa bieżącego zarejestrowanego operatora. Na przykład Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Zawiera informacje o telefonii powiązane z każdą kartą SIM na urządzeniu. Obsługiwane tylko na w pełni zarządzanych urządzeniach z Androidem w wersji API 23 lub nowszej.

TelephonyInfo

Zapis JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Pola
phoneNumber

string

Numer telefonu powiązany z tą kartą SIM.
carrierName

string

Nazwa operatora powiązana z tą kartą SIM.
iccId

string

Tylko dane wyjściowe. Numer ICCID powiązany z tą kartą SIM.
activationState

enum (ActivationState)

Tylko dane wyjściowe. Stan aktywacji karty SIM na urządzeniu. Dotyczy to tylko kart eSIM. Ta funkcja jest obsługiwana na wszystkich urządzeniach z interfejsem API na poziomie 35 lub nowszym. W przypadku fizycznych kart SIM i urządzeń z poziomem interfejsu API niższym niż 35 ta wartość jest zawsze ACTIVATION_STATE_UNSPECIFIED.
configMode

enum (ConfigMode)

Tylko dane wyjściowe. Tryb konfiguracji karty SIM na urządzeniu. Dotyczy to tylko kart eSIM. Ta funkcja jest obsługiwana na wszystkich urządzeniach z interfejsem API na poziomie 35 lub nowszym. W przypadku fizycznych kart SIM i urządzeń z poziomem interfejsu API niższym niż 35 ta wartość jest zawsze CONFIG_MODE_UNSPECIFIED.

MemoryInfo

Zapis JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Pola
totalRam

string (int64 format)

Łączna pamięć RAM urządzenia w bajtach.
totalInternalStorage

string (int64 format)

Łączna ilość pamięci wewnętrznej urządzenia w bajtach.

MemoryEvent

Zapis JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Pola
eventType

enum (MemoryEventType)

Typ zdarzenia.
createTime

string (Timestamp format)

Czas utworzenia wydarzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

Liczba wolnych bajtów na nośniku lub w przypadku EXTERNAL_STORAGE_DETECTED łączna pojemność nośnika danych w bajtach.

PowerManagementEvent

Zapis JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Pola
eventType

enum (PowerManagementEventType)

Typ zdarzenia.
createTime

string (Timestamp format)

Czas utworzenia wydarzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
batteryLevel

number

W przypadku zdarzeń BATTERY_LEVEL_COLLECTED poziom baterii w procentach.

HardwareStatus

Zapis JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Pola
createTime

string (Timestamp format)

Czas wykonania pomiarów.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

Aktualna temperatura baterii w stopniach Celsjusza dla każdej baterii na urządzeniu.
cpuTemperatures[]

number

Aktualne temperatury procesora w stopniach Celsjusza dla każdego procesora na urządzeniu.
gpuTemperatures[]

number

Aktualne temperatury GPU w stopniach Celsjusza dla każdego GPU na urządzeniu.
skinTemperatures[]

number

Aktualna temperatura skóry urządzenia w stopniach Celsjusza.
fanSpeeds[]

number

Prędkości wentylatorów w obr./min dla każdego wentylatora na urządzeniu. Pusta tablica oznacza, że w systemie nie ma wentylatorów lub szybkość wentylatora nie jest obsługiwana.
cpuUsages[]

number

Wykorzystanie procesora w procentach dla każdego rdzenia dostępnego na urządzeniu. Wykorzystanie każdego odłączonego rdzenia wynosi 0. Pusta tablica oznacza, że użycie procesora nie jest obsługiwane w systemie.

DeviceSettings

Zapis JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Pola
isDeviceSecure

boolean

Czy urządzenie jest zabezpieczone kodem PIN lub hasłem.
unknownSourcesEnabled

boolean

Określa, czy instalowanie aplikacji z nieznanych źródeł jest włączone.
developmentSettingsEnabled

boolean

Czy na urządzeniu jest włączony tryb programisty.
adbEnabled

boolean

Określa, czy na urządzeniu jest włączony ADB.
isEncrypted

boolean

Określa, czy szyfrowanie pamięci masowej jest włączone.
encryptionStatus

enum (EncryptionStatus)

Stan szyfrowania z DevicePolicyManager.
verifyAppsEnabled

boolean

Czy na urządzeniu jest wymuszana weryfikacja Google Play Protect.

Użytkownik

Zapis JSON 
{
  "accountIdentifier": string
}
Pola
accountIdentifier

string

Unikalny identyfikator utworzony przez Ciebie dla tego użytkownika, np. user342 lub asset#44418. To pole musi być ustawione podczas tworzenia użytkownika i nie można go zaktualizować. To pole nie może zawierać informacji umożliwiających identyfikację. Ten identyfikator nie może mieć więcej niż 1024 znaki. W przeciwnym razie żądanie aktualizacji zasad zakończy się niepowodzeniem.

SystemPropertiesEntry

Zapis JSON 
{
  "key": string,
  "value": string
}
Pola
key

string
value

string

SecurityPosture

Zapis JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Pola
devicePosture

enum (DevicePosture)

Wartość stanu zabezpieczeń urządzenia.
postureDetails[]

object (PostureDetail)

Dodatkowe informacje o stanie zabezpieczeń urządzenia.

PostureDetail

Zapis JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Pola
securityRisk

enum (SecurityRisk)

Konkretne zagrożenie dla bezpieczeństwa, które negatywnie wpływa na stan zabezpieczeń urządzenia.
advice[]

object (UserFacingMessage)

Odpowiednie wskazówki dla administratora, które pomogą zmniejszyć to ryzyko i zwiększyć bezpieczeństwo urządzenia.

CommonCriteriaModeInfo

Zapis JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
Pola
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Wskazuje, czy tryb Common Criteria jest włączony.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Tylko dane wyjściowe. Stan weryfikacji podpisu zasad.

PasswordRequirements

Zapis JSON 
{
  "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)
}
Pola
passwordMinimumLength

integer

Minimalna dozwolona długość hasła. Wartość 0 oznacza brak ograniczeń. Wymagane tylko wtedy, gdy wartość parametru password_quality to NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC lub COMPLEX.
passwordMinimumLetters

integer

Minimalna liczba liter wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.
passwordMinimumLowerCase

integer

Minimalna liczba małych liter wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.
passwordMinimumNonLetter

integer

Minimalna liczba znaków innych niż litery (cyfr lub symboli) wymaganych w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.
passwordMinimumNumeric

integer

Minimalna liczba cyfr wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.
passwordMinimumSymbols

integer

Minimalna liczba symboli wymagana w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.
passwordMinimumUpperCase

integer

Minimalna liczba wielkich liter wymaganych w haśle. Wymuszane tylko wtedy, gdy password_quality ma wartość COMPLEX.
passwordQuality

enum (PasswordQuality)

Wymagana jakość hasła.
passwordHistoryLength

integer

Długość historii haseł. Po ustawieniu tego pola użytkownik nie będzie mógł wpisać nowego hasła, które jest takie samo jak którekolwiek hasło w historii. Wartość 0 oznacza brak ograniczeń.
maximumFailedPasswordsForWipe

integer

Liczba nieprawidłowych haseł odblokowujących urządzenie, które można wpisać przed wyczyszczeniem urządzenia. Wartość 0 oznacza brak ograniczeń.
passwordExpirationTimeout

string (Duration format)

Czas wygaśnięcia hasła.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
passwordScope

enum (PasswordPolicyScope)

Zakres, którego dotyczy wymaganie dotyczące hasła.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Okres, po którym urządzenie lub profil służbowy odblokowany za pomocą silnej formy uwierzytelniania (hasła, kodu PIN, wzoru) może zostać odblokowany za pomocą dowolnej innej metody uwierzytelniania (np. odcisku palca, zaufanych agentów, rozpoznawania twarzy). Po upływie określonego czasu do odblokowania urządzenia lub profilu służbowego można używać tylko silnych metod uwierzytelniania.
unifiedLockSettings

enum (UnifiedLockSettings)

Określa, czy na urządzeniach z Androidem 9 lub nowszym z profilem służbowym dozwolona jest ujednolicona blokada urządzenia i profilu służbowego. Można ją skonfigurować tylko wtedy, gdy zasada password_scope ma wartość SCOPE_PROFILE. W przeciwnym razie zasada zostanie odrzucona. Jeśli użytkownik nie ustawił osobnej blokady służbowej, a to pole ma wartość REQUIRE_SEPARATE_WORK_LOCK, zgłaszany jest NonComplianceDetail z polem nonComplianceReason ustawionym na USER_ACTION.

Czas trwania

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Podpisane sekundy przedziału czasu. Musi mieścić się w zakresie od -315 576 000 000 do +315 576 000 000 włącznie. Uwaga: te granice są obliczane na podstawie: 60 s/min * 60 min/godz. * 24 godz./dzień * 365,25 dni/rok * 10 000 lat.
nanos

integer

Podpisane ułamki sekundy w nanosekundowej rozdzielczości przedziału czasu. Czasy trwania krótsze niż sekunda są reprezentowane przez pole 0 seconds i pole nanos z wartością dodatnią lub ujemną. W przypadku czasów trwania wynoszących co najmniej 1 sekundę wartość pola nanos musi mieć ten sam znak co pole seconds. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie.

DpcMigrationInfo

Zapis JSON 
{
  "previousDpc": string,
  "additionalData": string
}
Pola
previousDpc

string

Tylko dane wyjściowe. Jeśli to urządzenie zostało przeniesione z innego DPC, jest to jego nazwa pakietu. W innych przypadkach nie jest wypełniane.
additionalData

string

Tylko dane wyjściowe. Jeśli to urządzenie zostało przeniesione z innego dostawcy DPC, w tym miejscu zostanie wypełnione pole additionalData tokena migracji.

DefaultApplicationInfo

Zapis JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Pola
defaultApplicationType

enum (DefaultApplicationType)

Tylko dane wyjściowe. Domyślny typ aplikacji.
packageName

string

Tylko dane wyjściowe. Nazwa pakietu bieżącej domyślnej aplikacji.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Tylko dane wyjściowe. Szczegóły domyślnych prób ustawienia aplikacji w tej samej kolejności co na liście w defaultApplications.

DefaultApplicationSettingAttempt

Zapis JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Pola
packageName

string

Tylko dane wyjściowe. Nazwa pakietu aplikacji, której dotyczy próba.
attemptOutcome

enum (AttemptOutcome)

Tylko dane wyjściowe. Wynik ustawienia aplikacji jako domyślnej.

Adnotacje do narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌