REST Resource: enterprises.devices

Zasób: urządzenie

Urządzenie należące do firmy. O ile nie zaznaczono inaczej, wszystkie pola są tylko do odczytu i nie mogą być modyfikowane przez funkcję enterprises.devices.patch.

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)
  }
}
Pola
name

string

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

string

Nazwa zasobu użytkownika, do którego należy urządzenie, w formacie enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

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

enum (DeviceState)

Stan, który zostanie zastosowany do urządzenia. To pole można modyfikować przez żądanie poprawki. Pamiętaj, że podczas wywoływania funkcji enterprises.devices.patch, ACTIVE i DISABLED są to jedyne dozwolone wartości. Aby wprowadzić urządzenie w stanie DELETED, wywołaj enterprises.devices.delete.
appliedState

enum (DeviceState)

Obecny stan urządzenia.
policyCompliant

boolean

Wskazuje, czy urządzenie jest zgodne ze swoimi 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.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

Czas ostatniego wysłania raportu o stanie z urządzenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Rola wycofana.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

Czas ostatniego pobrania zasad przez urządzenie.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
policyName

string

Nazwa zasady zastosowanej do urządzenia: enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie określono tego ustawienia, stosowana jest zasada policyName dotycząca użytkownika urządzenia. To pole można modyfikować przez żądanie poprawki. Przy wywołaniu funkcji enterprises.devices.patch możesz określić tylko policyId, o ile policyId nie zawiera żadnych ukośników. Pozostała część nazwy zasady jest ustalana na podstawie danych.
appliedPolicyName

string

Nazwa zasady, która jest obecnie stosowana na urządzeniu.
appliedPolicyVersion

string (int64 format)

Wersja zasady, która jest obecnie stosowana na urządzeniu.
apiLevel

integer

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

string

Jeśli urządzenie zostało zarejestrowane przy użyciu tokena rejestracji z dodatkowymi danymi, to pole zawiera te dane.
enrollmentTokenName

string

Jeśli urządzenie zostało zarejestrowane przy użyciu tokena rejestracji, to pole zawiera nazwę tokena.
disabledReason

object (UserFacingMessage)

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

object (SoftwareInfo)

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

object (HardwareInfo)

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

object (Display)

Szczegółowe informacje o wyświetlaniu na urządzeniu. Te informacje są dostępne tylko wtedy, gdy displayInfoEnabled w zasadach urządzenia 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 applicationReportsEnabled ma wartość prawda.
previousDeviceNames[]

string

Jeśli to samo urządzenie fizyczne zostało zarejestrowane wiele razy, to pole będzie zawierać jego poprzednie nazwy. Numer seryjny jest używany jako unikalny identyfikator do określania, czy dane urządzenie fizyczne zostało już wcześniej zarejestrowane. Nazwy są uporządkowane chronologicznie.
networkInfo

object (NetworkInfo)

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

object (MemoryInfo)

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

object (MemoryEvent)

Zdarzenia związane z pomiarami pamięci i miejsca na dane w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy memoryInfoEnabled w zasadach urządzenia ma wartość prawda.

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

object (PowerManagementEvent)

Zdarzenia dotyczące zarządzania zasilaniem urządzenia w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy powerManagementEventsEnabled w zasadach urządzenia ma wartość prawda.
hardwareStatusSamples[]

object (HardwareStatus)

Przykłady stanu sprzętu w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy hardwareStatusEnabled w zasadach urządzenia ma wartość prawda.
deviceSettings

object (DeviceSettings)

Informacje o ustawieniach urządzenia. Te informacje są dostępne tylko wtedy, gdy deviceSettingsEnabled w zasadach urządzenia 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 systemu związanych z urządzeniem. Te informacje są dostępne tylko wtedy, gdy systemPropertiesEnabled w zasadach urządzenia 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 jego poziom bezpieczeństwa.
ownership

enum (Ownership)

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

object (CommonCriteriaModeInfo)

Informacje o trybie Common Criteria, czyli standardach zabezpieczeń zdefiniowanych w dokumencie Common Criteria for Information Technology Security Evaluation (w języku angielskim),

Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia statusReportingSettings.commonCriteriaModeEnabled ma wartość true, które należy do firmy.
appliedPasswordPolicies[]

object (PasswordRequirements)

Wymagania dotyczące hasła obowiązujące obecnie na urządzeniu.

  • W niektórych przypadkach obowiązujące wymagania mogą się nieznacznie różnić od tych określonych w zasadzie passwordPolicies.
  • Pole fieldPath jest ustawione na podstawie: passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Tylko dane wyjściowe. Informacje o tym, czy to urządzenie zostało przeniesione z zarządzania nim przez inny kontroler zasad dotyczących urządzeń (DPC).

DeviceState

Stany, które mogą mieć zastosowanie do urządzenia.

Wartości w polu enum
DEVICE_STATE_UNSPECIFIED Ta wartość jest niedozwolona.
ACTIVE Urządzenie jest aktywne.
DISABLED Urządzenie jest wyłączone.
DELETED Urządzenie zostało usunięte. Ten stan nigdy nie jest zwracany przez wywołanie interfejsu API, ale jest używany w ostatecznym raporcie o stanie, gdy urządzenie potwierdzi usunięcie. Jeśli urządzenie zostanie usunięte za pomocą wywołania interfejsu API, ten stan zostanie opublikowany w Pub/Sub. Jeśli użytkownik usunie profil służbowy lub zresetuje urządzenie, stan urządzenia pozostanie nieznany serwerowi.
PROVISIONING Trwa rejestrowanie urządzenia. Nowo zarejestrowane urządzenia pozostaną w tym stanie, dopóki nie zostaną zastosowane zasady.
LOST urządzenie zostało utracone, Ten stan jest możliwy tylko na urządzeniach należących do organizacji.
PREPARING_FOR_MIGRATION Urządzenie przygotowuje się do migracji do interfejsu Android Management API. Aby kontynuować migrację, nie musisz nic więcej robić.
DEACTIVATED_BY_DEVICE_FINANCE To jest finansowane urządzenie, które zostało „zablokowane” przez agenta finansowania. Oznacza to, że zostały zastosowane pewne ustawienia zasad, które ograniczają funkcjonalność urządzenia do czasu jego „odblokowania” przez agenta finansowania. Urządzenie będzie nadal stosować ustawienia zasad z wyjątkiem tych, które zostały zastąpione przez agenta finansowania. Gdy urządzenie jest „zablokowane”, stan jest zgłaszany w appliedState jako DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Podaje szczegółowe informacje o niezgodności z ustawieniem zasad.

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 zasad. Jest to nazwa pola JSON Policy najwyższego poziomu.
nonComplianceReason

enum (NonComplianceReason)

Przyczyna niezgodności urządzenia z tym ustawieniem.
packageName

string

Nazwa pakietu wskazująca, która aplikacja jest niezgodna (w odpowiednich przypadkach).
fieldPath

string

Jeśli dane zagnieżdżone pole jest niezgodne z ustawieniami z zagnieżdżonymi polami, określa się pełną ścieżkę do niewłaściwego pola. Ścieżka jest sformatowana w taki sam sposób, w jaki kod JavaScript odwołuje się do pola JSON zasad, czyli: 1) W przypadku pól o typie obiektu po nazwie pola następuje kropka, a po niej nazwa pola podrzędnego. 2) W przypadku pól o typie tablicowym po nazwie pola znajduje się indeks tablicy w nawiasach kwadratowych. Na przykład w celu wskazania problemu z polem url w polu externalData w trzeciej aplikacji ścieżka będzie wyglądać tak: applications[2].externalData.url.
currentValue

value (Value format)

Jeśli nie udało się zastosować ustawienia zasad, bieżąca wartość ustawienia na urządzeniu.
installationFailureReason

enum (InstallationFailureReason)

Jeśli skonfigurowano zasadę packageName, a przyczyna niezgodności to APP_NOT_INSTALLED lub APP_NOT_UPDATED, szczegółowy powód nie można zainstalować ani zaktualizować aplikacji.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Przyczyna niezgodności urządzenia z określonym ustawieniem.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Dodatkowy kontekst dla: specificNonComplianceReason.

InstallationFailureReason

Przyczyny niepowodzenia instalacji aplikacji.

Wartości w polu enum
INSTALLATION_FAILURE_REASON_UNSPECIFIED Ta wartość jest niedozwolona.
INSTALLATION_FAILURE_REASON_UNKNOWN Nieznany warunek uniemożliwia zainstalowanie aplikacji. Możliwe przyczyny to za mało miejsca na urządzeniu, niestabilne połączenie sieciowe lub fakt, że instalacja trwa dłużej niż zwykle. Próba instalacji zostanie ponowiona automatycznie.
IN_PROGRESS Nadal trwa instalacja.
NOT_FOUND Nie znaleziono aplikacji w Google Play.
NOT_COMPATIBLE_WITH_DEVICE Aplikacja jest niezgodna z urządzeniem.
NOT_APPROVED Aplikacja nie została zatwierdzona przez administratora.
PERMISSIONS_NOT_ACCEPTED Aplikacja ma nowe uprawnienia, które nie zostały zaakceptowane przez administratora.
NOT_AVAILABLE_IN_COUNTRY Aplikacja jest niedostępna w kraju użytkownika.
NO_LICENSES_REMAINING Brak licencji do przypisania użytkownikowi.
NOT_ENROLLED Grupa nie jest już zarejestrowana w zarządzanym Sklepie Google Play lub administrator nie zaakceptował najnowszych Warunków korzystania z usługi Zarządzany Sklep Google Play.
USER_INVALID Konto użytkownika nie jest już prawidłowe. Konto użytkownika mogło zostać usunięte lub wyłączone.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Błąd sieci na urządzeniu użytkownika uniemożliwił instalację. Zwykle dzieje się tak, gdy połączenie z internetem urządzenia jest pogorszone, niedostępne lub występuje problem z konfiguracją sieci. Upewnij się, że urządzenie ma pełne połączenie z internetem w sieci zgodnej z Android Enterprise Network Requirements. W takim przypadku instalacja lub aktualizacja aplikacji zostanie automatycznie wznowiona.
INSUFFICIENT_STORAGE Na urządzeniu użytkownika nie ma wystarczającej ilości miejsca, aby zainstalować aplikację. Można rozwiązać ten problem, zwalniając miejsce na urządzeniu. Instalacja lub aktualizacja aplikacji zostanie automatycznie wznowiona, gdy na urządzeniu będzie wystarczająca ilość miejsca.

SpecificNonComplianceReason

Więcej informacji o przyczynie niezgodności urządzenia z ustawieniem zasad W przyszłości możesz dodawać do wyliczenia nowe wartości.

Wartości w polu enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Nie podano konkretnej przyczyny niezgodności. Pola w tabeli specificNonComplianceContext nie zostały ustawione.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Użytkownik musi potwierdzić dane logowania, wprowadzając blokadę ekranu. Pola w tabeli specificNonComplianceContext nie zostały ustawione. nonComplianceReason ma wartość USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Hasło urządzenia lub profilu wygasło. Ustawiono: passwordPoliciesContext. nonComplianceReason ma wartość USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Hasło urządzenia nie spełnia wymagań dotyczących haseł. Ustawiono: passwordPoliciesContext. nonComplianceReason ma wartość USER_ACTION.
ONC_WIFI_INVALID_VALUE Konfiguracja Wi-Fi ONC zawiera nieprawidłową wartość. fieldPath określa, która wartość pola jest nieprawidłowa. Ustawiono: oncWifiContext. nonComplianceReason ma wartość INVALID_VALUE.
ONC_WIFI_API_LEVEL Ustawienie Wi-Fi ONC nie jest obsługiwane na poziomie interfejsu API wersji Androida uruchomionej na urządzeniu. fieldPath określa, która wartość pola nie jest obsługiwana. Ustawiono: oncWifiContext. nonComplianceReason ma wartość API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG W firmowej sieci Wi-Fi brakuje głównego urzędu certyfikacji lub nazwy domeny. nonComplianceReason ma wartość INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK Użytkownik musi ręcznie usunąć skonfigurowaną sieć Wi-Fi. Dotyczy to tylko profili służbowych na należących do Ciebie urządzeniach. nonComplianceReason ma wartość USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY Alias pary kluczy podany w polu ClientCertKeyPairAlias w systemie openNetworkConfiguration nie odpowiada istniejącemu kluczowi zainstalowanemu na urządzeniu. nonComplianceReason ma wartość INVALID_VALUE.

SpecificNonComplianceContext

Dodatkowy kontekst dla: SpecificNonComplianceReason.

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

object (OncWifiContext)

Dodatkowy kontekst związany z niezgodnością związaną z konfiguracją Wi-Fi. Zobacz ONC_WIFI_INVALID_VALUE i ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

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

OncWifiContext

Dodatkowy kontekst związany z niezgodnością związaną z konfiguracją Wi-Fi.

Zapis JSON 
{
  "wifiGuid": string
}
Pola
wifiGuid

string

Identyfikator GUID niezgodnej konfiguracji Wi-Fi.

PasswordPoliciesContext

Dodatkowy kontekst dotyczący niezgodności w związku z zasadami dotyczącymi haseł.

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

enum (PasswordPolicyScope)

Zakres niezgodnego hasła.

SoftwareInfo

Informacje o oprogramowaniu urządzenia.

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żytkowników. 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 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 systemu rozruchowego, np. 0.6.7
androidBuildTime

string (Timestamp format)

Czas kompilacji.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
securityPatchLevel

string

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

string

Kod języka IETF BCP 47 dla głównego języka urządzenia.
deviceBuildSignature

string

Skrót SHA-256 obiektu android.content.pm.Signature powiązanego z pakietem systemowym. Służy do sprawdzania, czy kompilacja systemu nie została zmodyfikowana.
systemUpdateInfo

object (SystemUpdateInfo)

Informacje o potencjalnej oczekującej aktualizacji systemu.

SystemUpdateInfo

Informacje o potencjalnej oczekującej aktualizacji systemu.

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

enum (UpdateStatus)

Stan aktualizacji: informacje o tym, czy aktualizacja istnieje i jaki jest typ.
updateReceivedTime

string (Timestamp format)

Czas pierwszego udostępnienia aktualizacji. Wartość 0 oznacza, że to pole nie zostało ustawione. To pole jest ustawiane tylko wtedy, gdy dostępna jest aktualizacja (tzn. updateStatus to nie UPDATE_STATUS_UNKNOWN ani UP_TO_DATE).

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

UpdateStatus

Stan aktualizacji: informacje o tym, czy aktualizacja istnieje i jaki jest typ.

Wartości w polu enum
UPDATE_STATUS_UNKNOWN Nie wiadomo, czy istnieje oczekująca aktualizacja systemu. Dzieje się tak, gdy na przykład poziom interfejsu API urządzenia jest niższy niż 26 lub wersja Android Device Policy jest nieaktualna.
UP_TO_DATE Brak oczekujących aktualizacji systemu na urządzeniu.
UNKNOWN_UPDATE_AVAILABLE Dostępna jest oczekująca aktualizacja systemu, ale jej typ nie jest znany.
SECURITY_UPDATE_AVAILABLE Dostępna jest oczekująca aktualizacja zabezpieczeń.
OS_UPDATE_AVAILABLE Dostępna jest oczekująca aktualizacja systemu operacyjnego.

HardwareInfo

Informacje o sprzęcie urządzenia. Pola związane z progami temperatury są dostępne tylko wtedy, gdy zasada urządzenia ma wartość hardwareStatusEnabled.

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
}
Pola
brand

string

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

string

Nazwa urządzenia. 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.
model

string

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

number

Progi temperatury wyłączania baterii w stopniach Celsjusza dla każdej baterii urządzenia.
batteryThrottlingTemperatures[]

number

Progi temperatury ograniczania temperatury (w stopniach Celsjusza) dla każdej baterii urządzenia.
cpuShutdownTemperatures[]

number

Progi temperatury wyłączania procesora w stopniach Celsjusza dla każdego procesora urządzenia.
cpuThrottlingTemperatures[]

number

Progi ograniczania temperatury procesora wyrażone w stopniach Celsjusza dla każdego procesora urządzenia.
gpuShutdownTemperatures[]

number

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

number

Ograniczanie progów temperatury w GPU w stopniach Celsjusza dla każdego GPU na urządzeniu.
skinShutdownTemperatures[]

number

Progi temperatury wyłączania skóry urządzenia w stopniach Celsjusza.
skinThrottlingTemperatures[]

number

Ograniczanie progów temperatury skóry urządzenia w stopniach Celsjusza.
enterpriseSpecificId

string

Tylko dane wyjściowe. Jednoznaczny identyfikator urządzenia należącego do danej organizacji. Identyfikator ten pozostanie jednak zarejestrowany na tym samym urządzeniu fizycznym zarejestrowanym w tej samej organizacji, a nawet przywrócimy go do ustawień fabrycznych. Ten identyfikator jest dostępny na urządzeniach należących do użytkowników z profilem służbowym oraz na urządzeniach z Androidem 12 lub nowszym.

Sieć reklamowa

Informacje o urządzeniu.

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 wyświetlany identyfikator.
refreshRate

integer

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

enum (DisplayState)

Stan wyświetlacza.
width

integer

Szerokość wyświetlania w pikselach.
height

integer

Wyświetlana wysokość w pikselach.
density

integer

Układ interfejsu wyrażony jako kropki na cal.

DisplayState

Stan wyświetlacza.

Wartości w polu enum
DISPLAY_STATE_UNSPECIFIED Ta wartość jest niedozwolona.
OFF Wyświetlacz jest wyłączony.
ON Wyświetlacz jest włączony.
DOZE Wyświetlacz się wycisza i ma słabą moc
SUSPENDED Wyświetlacz jest zawieszony przy niskim napięciu

ApplicationReport

Zgłoszono informacje o zainstalowanej aplikacji.

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 umożliwia ustalenie, czy dana wersja jest nowsza od innej.
events[]

object (ApplicationEvent)

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

string

Wyświetlana nazwa aplikacji.
packageSha256Hash

string

Skrót SHA-256 pliku APK aplikacji. Służy do sprawdzania, czy aplikacja nie została zmodyfikowana. Każdy bajt wartości skrótu jest reprezentowany jako 2-cyfrowa liczba szesnastkowa.
signingKeyCertFingerprints[]

string

Skrót SHA-1 każdego obiektu android.content.pm.Signature powiązanego z pakietem aplikacji. Każdy bajt każdej wartości skrótu jest reprezentowany w postaci 2-cyfrowej liczby szesnastkowej.
installerPackageName

string

Nazwa pakietu aplikacji, w której zainstalowano tę aplikację.
applicationSource

enum (ApplicationSource)

Źródło pakietu.
state

enum (ApplicationState)

Stan aplikacji.
keyedAppStates[]

object (KeyedAppState)

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

enum (UserFacingType)

Określa, czy aplikacja jest widoczna dla użytkownika.

ApplicationEvent

Zdarzenie związane z aplikacją.

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

enum (ApplicationEventType)

Typ zdarzenia w aplikacji.
createTime

string (Timestamp format)

Czas utworzenia wydarzenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

ApplicationEventType

Rodzaj zdarzenia związanego z aplikacją.

Wartości w polu enum
APPLICATION_EVENT_TYPE_UNSPECIFIED Ta wartość jest niedozwolona.
INSTALLED Aplikacja została zainstalowana.
CHANGED zmieniono aplikację, np. włączono lub wyłączono komponent;
DATA_CLEARED Dane aplikacji zostały wyczyszczone.
REMOVED Aplikacja została usunięta.
REPLACED Zainstalowano nową wersję aplikacji, która zastępuje starą.
RESTARTED Aplikacja została ponownie uruchomiona.
PINNED Aplikacja została przypięta do pierwszego planu.
UNPINNED Aplikacja została odpięta.

ApplicationSource

Źródło, które udostępniło aplikację.

Wartości w polu enum
APPLICATION_SOURCE_UNSPECIFIED Aplikacja została pobrana z nieokreślonego źródła.
SYSTEM_APP_FACTORY_VERSION Jest to aplikacja systemowa z fabrycznego obrazu urządzenia.
SYSTEM_APP_UPDATED_VERSION To jest zaktualizowana aplikacja systemowa.
INSTALLED_FROM_PLAY_STORE Aplikacja została zainstalowana ze Sklepu Google Play.

ApplicationState

Bieżący stan instalacji.

Wartości w polu enum
APPLICATION_STATE_UNSPECIFIED Stan aplikacji nie jest określony
REMOVED Aplikacja została usunięta z urządzenia
INSTALLED Aplikacja jest zainstalowana na urządzeniu

KeyedAppState

Stan aplikacji z kluczem zgłoszony przez aplikację.

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

string

Klucz stanu aplikacji. Pełni rolę punktu odniesienia dla tego, w jakim stanie aplikacja dostarcza stan. Na przykład w przypadku przesyłania opinii o konfiguracji zarządzanej tym kluczem może być klucz konfiguracji zarządzanej.
severity

enum (Severity)

Waga stanu aplikacji.
message

string

Opcjonalnie: dowolny ciąg znaków komunikatu wyjaśniającego stan aplikacji. Jeśli stan został aktywowany przez konkretną wartość (np. wartość konfiguracji zarządzanej), należy to uwzględnić w komunikacie.
data

string

Opcjonalnie może to być czytelna dla komputera wartość do odczytu przez dostawcę usług EMM. Dotyczy to na przykład ustawiania wartości, których administrator może użyć w konsoli EMM (np. „Powiadom mnie, jeśli dane o baterii są mniejsze niż 10”).
createTime

string (Timestamp format)

Czas utworzenia stanu aplikacji na urządzeniu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

Godzina ostatniej aktualizacji stanu aplikacji.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Poziom ważności

Waga stanu aplikacji.

Wartości w polu enum
SEVERITY_UNSPECIFIED Nieokreślony poziom ważności.
INFO Poziom ważności informacji.
ERROR Poziom ważności błędu. Tę wartość należy ustawiać tylko w przypadku rzeczywistych błędów, które w celu rozwiązania problemu musi podjąć organizacja zarządzająca.

UserFacingType

Określa, czy aplikacja jest widoczna dla użytkownika.

Wartości w polu enum
USER_FACING_TYPE_UNSPECIFIED Typ aplikacji dla użytkowników nie jest określony.
NOT_USER_FACING Aplikacja nie jest widoczna dla użytkownika.
USER_FACING Aplikacja jest widoczna dla użytkownika.

NetworkInfo

Informacje o sieci urządzenia.

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

Nazwa alfabetyczna zarejestrowanego obecnie operatora. Na przykład Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Podaje informacje telefoniczne powiązane z każdą kartą SIM w urządzeniu. Obsługiwane tylko na w pełni zarządzanych urządzeniach z interfejsem API Androida na poziomie 23.

TelephonyInfo

Informacje telefoniczne związane z daną kartą SIM w urządzeniu. Obsługiwane tylko na w pełni zarządzanych urządzeniach z interfejsem API Androida na poziomie 23.

Zapis JSON 
{
  "phoneNumber": string,
  "carrierName": string
}
Pola
phoneNumber

string

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

string

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

MemoryInfo

Informacje o pamięci i miejscu na dane urządzenia.

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

string (int64 format)

Łączna ilość pamięci RAM na urządzeniu w bajtach.
totalInternalStorage

string (int64 format)

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

MemoryEvent

Zdarzenie związane z pomiarami pamięci i miejsca na dane.

Do odróżniania nowych i starych zdarzeń zalecamy użycie pola createTime.

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

enum (MemoryEventType)

Typ zdarzenia.
createTime

string (Timestamp format)

Czas utworzenia wydarzenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

Liczba wolnych bajtów w medium, czyli łączna pojemność medium pamięci masowej (EXTERNAL_STORAGE_DETECTED).

MemoryEventType

Typ zdarzenia.

Wartości w polu enum
MEMORY_EVENT_TYPE_UNSPECIFIED Nie określono. Brak wydarzeń tego typu.
RAM_MEASURED Ilość wolnego miejsca w pamięci RAM została zmierzona.
INTERNAL_STORAGE_MEASURED Zmierzono ilość wolnego miejsca w pamięci wewnętrznej.
EXTERNAL_STORAGE_DETECTED Wykryto nowe medium zewnętrzne. Zgłoszona liczba bajtów to łączna pojemność medium pamięci masowej.
EXTERNAL_STORAGE_REMOVED Usunięto nośnik pamięci zewnętrznej. Liczba bajtów w raporcie wynosi 0.
EXTERNAL_STORAGE_MEASURED Zmierzono ilość wolnego miejsca w zewnętrznym nośniku pamięci.

PowerManagementEvent

Zdarzenie dotyczące zarządzania energią.

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

enum (PowerManagementEventType)

Typ zdarzenia.
createTime

string (Timestamp format)

Czas utworzenia wydarzenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
batteryLevel

number

W przypadku zdarzeń typu BATTERY_LEVEL_COLLECTED poziom baterii jest wyrażony w procentach.

PowerManagementEventType

Typ zdarzenia.

Wartości w polu enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Nie określono. Brak wydarzeń tego typu.
BATTERY_LEVEL_COLLECTED Poziom baterii został zmierzony.
POWER_CONNECTED Urządzenie rozpoczęło się ładowanie.
POWER_DISCONNECTED Urządzenie przestało się ładować.
BATTERY_LOW Urządzenie przeszło w tryb oszczędzania energii.
BATTERY_OKAY Urządzenie wyłączyło tryb oszczędzania baterii.
BOOT_COMPLETED Urządzenie się uruchomiło.
SHUTDOWN Urządzenie zostało wyłączone.

HardwareStatus

Stan sprzętu. W celu określenia stanu sprzętu temperatury mogą być porównywane z progami temperatury dostępnymi w hardwareInfo r.

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.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
batteryTemperatures[]

number

Bieżąca temperatura baterii urządzenia (w stopniach Celsjusza) na każdą baterię urządzenia.
cpuTemperatures[]

number

Bieżąca temperatura procesora w stopniach Celsjusza dla każdego procesora urządzenia.
gpuTemperatures[]

number

Bieżące temperatury GPU w stopniach Celsjusza dla każdego GPU urządzenia.
skinTemperatures[]

number

Aktualne temperatury skóry urządzenia w stopniach Celsjusza.
fanSpeeds[]

number

Prędkość wentylatora (obr./min) dla każdego wentylatora urządzenia. Pusta tablica oznacza, że w urządzeniu nie ma wentylatorów lub system nie obsługuje prędkości wentylatora.
cpuUsages[]

number

Procentowe wykorzystanie procesora przez każdy rdzeń dostępny na urządzeniu. Wykorzystanie wynosi 0 na każdy odłączona rdzeń. Pusta tablica oznacza, że wykorzystanie procesora nie jest obsługiwane przez system.

DeviceSettings

Informacje o ustawieniach na urządzeniu związanych z bezpieczeństwem.

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

boolean

Określa, czy urządzenie jest zabezpieczone kodem PIN/hasłem.
unknownSourcesEnabled

boolean

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

boolean

Określa, czy na urządzeniu jest włączony tryb programisty.
adbEnabled

boolean

Określa, czy na urządzeniu jest włączona usługa ADB.
isEncrypted

boolean

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

enum (EncryptionStatus)

Stan szyfrowania z DevicePolicyManager.
verifyAppsEnabled

boolean

Określa, czy na urządzeniu jest wymuszana weryfikacja Google Play Protect.

EncryptionStatus

Stan szyfrowania urządzenia.

Wartości w polu enum
ENCRYPTION_STATUS_UNSPECIFIED Nie określono. Żadne urządzenie nie powinno mieć tego typu.
UNSUPPORTED Szyfrowanie nie jest obsługiwane przez urządzenie.
INACTIVE Szyfrowanie jest obsługiwane przez urządzenie, ale nie jest obecnie aktywne.
ACTIVATING Szyfrowanie nie jest obecnie aktywne, ale jest obecnie aktywowane.
ACTIVE Szyfrowanie jest aktywne.
ACTIVE_DEFAULT_KEY Szyfrowanie jest aktywne, ale użytkownik nie ustawił klucza szyfrowania.
ACTIVE_PER_USER Szyfrowanie jest aktywne, a klucz szyfrowania jest powiązany z profilem użytkownika.

SecurityPosture

Stan zabezpieczeń urządzenia określony na podstawie jego bieżącego stanu i zastosowanych zasad.

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

enum (DevicePosture)

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

object (PostureDetail)

Dodatkowe informacje na temat stanu zabezpieczeń urządzenia.

DevicePosture

Możliwe wartości stanu zabezpieczeń zarządzanego urządzenia.

Wartości w polu enum
POSTURE_UNSPECIFIED Nie określono. Brak szczegółów stanu dla tej wartości stanu.
SECURE To urządzenie jest bezpieczne.
AT_RISK To urządzenie może być bardziej narażone na złośliwe ataki niż zalecane do używania z danymi firmy.
POTENTIALLY_COMPROMISED To urządzenie mogło zostać przejęte, a dane firmowe mogą stać się dostępne dla nieautoryzowanych osób.

PostureDetail

Dodatkowe informacje na temat stanu zabezpieczeń urządzenia.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

Porady dla administratora dotyczące ograniczania ryzyka związanego z bezpieczeństwem i poprawy stanu zabezpieczeń urządzenia.

SecurityRisk

Ryzyko, dla którego urządzenie nie jest w najlepszym stanie.

Wartości w polu enum
SECURITY_RISK_UNSPECIFIED Nie określono.
UNKNOWN_OS Interfejs Play Integrity API wykrywa, że na urządzeniu działa nieznany system operacyjny (test integralności plasuje się poprawnie, ale ctsProfileMatch nie działa).
COMPROMISED_OS Interfejs Play Integrity API wykryje, że na urządzeniu działa zhakowany system operacyjny (test podstawowej integralności kończy się niepowodzeniem).
HARDWARE_BACKED_EVALUATION_FAILED Interfejs Play Integrity API wykrywa, że urządzenie nie ma gwarancji integralności systemu, gdy w polu integralności urządzenia nie widać etykiety MEETS_STRONG_INTEGRITY.

CommonCriteriaModeInfo

Informacje o trybie Common Criteria, czyli standardach zabezpieczeń zdefiniowanych w dokumencie Common Criteria for Information Technology Security Evaluation (w języku angielskim),

Te informacje są dostępne tylko wtedy, gdy w zasadach urządzenia statusReportingSettings.commonCriteriaModeEnabled ma wartość true.

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

enum (CommonCriteriaModeStatus)

Określa, czy włączony jest tryb Common Criteria.

CommonCriteriaModeStatus

Określa, czy włączony jest tryb Common Criteria.

Wartości w polu enum
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Nieznany stan.
COMMON_CRITERIA_MODE_DISABLED Tryb Common Criteria jest obecnie wyłączony.
COMMON_CRITERIA_MODE_ENABLED Tryb Common Criteria jest obecnie włączony.

DpcMigrationInfo

Informacje o tym, czy to urządzenie zostało przeniesione z zarządzania nim przez inny kontroler zasad dotyczących urządzeń (DPC).

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 nazwa jego pakietu. W przeciwnym razie pole nie zostanie wypełnione.
additionalData

string

Tylko dane wyjściowe. Jeśli to urządzenie zostało przeniesione z innego DPC, pole additionalData tokena migracji jest tutaj wypełnione.

Metody

delete

 Usuwa urządzenie.

get

 Pobiera urządzenie.

issueCommand

 Wydaje polecenie urządzeniu.

list

 Wyświetla listę urządzeń w danej firmie.

patch

 Aktualizuje urządzenie.