REST Resource: enterprises.devices

Zasób: Device

Urządzenie należące do firmy. O ile nie wskazano inaczej, wszystkie pola są tylko do odczytu i nie można ich modyfikować za pomocą 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, który jest właścicielem tego urządzenia, w formacie enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Typ trybu zarządzania, który aplikacja 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óły ustawień zasad, z którymi urządzenie jest niezgodne.
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 raz, kiedy urządzenie pobrało zasady.

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 policyName 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 applicationReportsEnabled 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 starsze 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.

  • W niektórych przypadkach zastosowane wymagania mogą się nieznacznie różnić od tych określonych w passwordPolicies.
  • Wartość fieldPath jest ustawiana na podstawie passwordPolicies.
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).

DeviceState

Stany, które można zastosować 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 raporcie o stanie końcowym, gdy urządzenie potwierdzi usunięcie. Jeśli urządzenie zostanie usunięte za pomocą wywołania interfejsu API, ten stan zostanie opublikowany w usłudze Pub/Sub. Jeśli użytkownik usunie profil służbowy lub zresetuje urządzenie, stan urządzenia pozostanie nieznany dla serwera.
PROVISIONING Urządzenie jest obsługiwane. Nowo zarejestrowane urządzenia są w tym stanie, dopóki nie zostaną na nich 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 robić.
DEACTIVATED_BY_DEVICE_FINANCE Jest to urządzenie kupione na kredyt, które zostało „zablokowane” przez firmę finansującą. Oznacza to, że zastosowano określone ustawienia zasad, które ograniczają funkcjonalność urządzenia, dopóki nie zostanie ono „odblokowane” przez podmiot finansujący. Urządzenie będzie nadal stosować ustawienia zasad z wyjątkiem tych, które zostały zastąpione przez agenta finansowego. Gdy urządzenie jest „zablokowane”, stan jest zgłaszany w appliedState jako DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Zawiera 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 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 zasad 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 zasady nie można zastosować, wyświetlana jest bieżąca wartość ustawienia na urządzeniu.
installationFailureReason

enum (InstallationFailureReason)

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

enum (SpecificNonComplianceReason)

Przyczyna niezgodności urządzenia z ustawieniem, która jest związana z zasadami.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Dodatkowy kontekst dla specificNonComplianceReason.

InstallationFailureReason

Przyczyny, dla których instalacja aplikacji może się nie udać.

Wartości w polu enum
INSTALLATION_FAILURE_REASON_UNSPECIFIED Ta wartość jest niedozwolona.
INSTALLATION_FAILURE_REASON_UNKNOWN Nieznany problem uniemożliwia zainstalowanie aplikacji. Może to być spowodowane niewystarczającą ilością miejsca na urządzeniu, niestabilnym połączeniem sieciowym lub tym, że instalacja trwa dłużej niż oczekiwano. Instalacja zostanie automatycznie ponowiona.
IN_PROGRESS Instalacja wciąż trwa.
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 Nie ma licencji, które można przypisać użytkownikowi.
NOT_ENROLLED Firma nie jest już zarejestrowana w zarządzanym Sklepie Google Play lub administrator nie zaakceptował najnowszych Warunków usługi zarządzanego Sklepu Google Play.
USER_INVALID Użytkownik stracił ważność. Użytkownik mógł zostać usunięty lub wyłączony.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Błąd sieci na urządzeniu użytkownika uniemożliwił instalację. Zwykle dzieje się tak, gdy połączenie urządzenia z internetem jest słabe lub niedostępne albo występuje problem z konfiguracją sieci. Sprawdź, czy urządzenie ma pełny dostęp do internetu w sieci, która spełnia wymagania Android Enterprise Network Requirements. Gdy tak się stanie, instalacja lub aktualizacja aplikacji zostanie automatycznie wznowiona.
INSUFFICIENT_STORAGE Na urządzeniu użytkownika nie ma wystarczającej ilości miejsca na zainstalowanie aplikacji. Można to rozwiązać, zwalniając miejsce na urządzeniu. Instalacja lub aktualizacja aplikacji zostanie automatycznie wznowiona, gdy na urządzeniu będzie wystarczająco dużo miejsca.

SpecificNonComplianceReason

Więcej informacji o tym, dlaczego urządzenie może nie być zgodne z ustawieniem zasady. W przyszłości do wyliczenia można dodawać nowe wartości.

Wartości w polu enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Nie podano konkretnego powodu niezgodności. Pola w specificNonComplianceContext nie są ustawione.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Użytkownik musi potwierdzić dane logowania, wpisując kod blokady ekranu. Pola w specificNonComplianceContext nie są ustawione. nonComplianceReason ma wartość USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Hasło urządzenia lub profilu wygasło. passwordPoliciesContext jest ustawiona. nonComplianceReason ma wartość USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Hasło do urządzenia nie spełnia wymagań dotyczących haseł. passwordPoliciesContext jest ustawiona. nonComplianceReason ma wartość USER_ACTION.
ONC_WIFI_INVALID_VALUE W konfiguracji Wi-Fi ONC występuje nieprawidłowa wartość. fieldPath określa, która wartość pola jest nieprawidłowa. oncWifiContext jest ustawiona. nonComplianceReason ma wartość INVALID_VALUE.
ONC_WIFI_API_LEVEL Ustawienie Wi-Fi ONC nie jest obsługiwane na poziomie API wersji Androida działającej na urządzeniu. fieldPath określa, która wartość pola nie jest obsługiwana. oncWifiContext jest ustawiona. nonComplianceReason ma wartość API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG W sieci Wi-Fi dla firm 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 urządzeniach należących do pracowników. nonComplianceReason ma wartość USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY Alias pary kluczy podany w polu ClientCertKeyPairAlias w openNetworkConfiguration nie odpowiada istniejącemu kluczowi zainstalowanemu na urządzeniu. nonComplianceReason ma wartość INVALID_VALUE.
PERMISSIBLE_USAGE_RESTRICTION To ustawienie zasad jest ograniczone i nie można go skonfigurować w tym projekcie Google Cloud Platform. Więcej informacji (w tym o tym, jak włączyć korzystanie z tego ustawienia zasad) znajdziesz w zasadach dopuszczalnego użytkowania. nonComplianceReason ma wartość PROJECT_NOT_PERMITTED.
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE Konto służbowe wymagane przez ustawienie zasad workAccountSetupConfig nie jest już częścią firmy. nonComplianceReason ma wartość USER_ACTION.
NEW_ACCOUNT_NOT_IN_ENTERPRISE Konto służbowe dodane przez użytkownika nie należy do firmy. nonComplianceReason ma wartość USER_ACTION.

SpecificNonComplianceContext

Dodatkowy kontekst dla SpecificNonComplianceReason.

Zapis JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
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.

OncWifiContext

Dodatkowy kontekst dotyczący niezgodności związanej z konfiguracją Wi-Fi.

Zapis JSON 
{
  "wifiGuid": string
}
Pola
wifiGuid

string

Identyfikator GUID niezgodnej konfiguracji Wi-Fi.

PasswordPoliciesContext

Dodatkowy kontekst dotyczący niezgodności 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ż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

Hash SHA-256 pliku android.content.pm.Signature powiązanego z pakietem systemowym, który może służyć do weryfikacji, 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: czy aktualizacja istnieje i jakiego jest typu.
updateReceivedTime

string (Timestamp format)

Czas, w którym aktualizacja stała się dostępna. Wartość 0 oznacza, że to pole nie jest ustawione. To pole jest ustawiane tylko wtedy, gdy dostępna jest 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".

UpdateStatus

Stan aktualizacji: czy aktualizacja istnieje i jakiego jest typu.

Wartości w polu enum
UPDATE_STATUS_UNKNOWN Nie wiadomo, czy jest dostępna aktualizacja systemu. Dzieje się tak na przykład wtedy, gdy poziom interfejsu API urządzenia jest niższy niż 26 lub gdy wersja aplikacji Android Device Policy jest nieaktualna.
UP_TO_DATE Na urządzeniu nie ma oczekujących aktualizacji systemu.
UNKNOWN_UPDATE_AVAILABLE Dostępna jest oczekująca aktualizacja systemu, ale jej typ jest nieznany.
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 hardwareStatusEnabled ma wartość Prawda w zasadach urządzenia.

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.
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 skóry urządzenia w stopniach Celsjusza.
skinThrottlingTemperatures[]

number

Progi temperatury skóry urządzenia 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 dotyczące karty eUICC.

EuiccChipInfo

Informacje dotyczące karty eUICC.

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

Informacje o wyświetlaczu urządzenia.

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.

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 jest w stanie uśpienia o niskim zużyciu energii.
SUSPENDED Wyświetlacz jest w stanie uśpienia o niskim zużyciu energii.

ApplicationReport

Informacje zgłaszane 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 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

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.

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".

ApplicationEventType

Typ zdarzenia związanego z aplikacją.

Wartości w polu enum
APPLICATION_EVENT_TYPE_UNSPECIFIED Ta wartość jest niedozwolona.
INSTALLED Aplikacja została zainstalowana.
CHANGED Aplikacja została zmieniona, np. włączono lub wyłączono jej składnik.
DATA_CLEARED Dane aplikacji zostały wyczyszczone.
REMOVED Aplikacja została usunięta.
REPLACED Została zainstalowana nowa wersja aplikacji, która zastąpiła starą.
RESTARTED Aplikacja została ponownie uruchomiona.
PINNED Aplikacja została przypięta na pierwszym planie.
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 zainstalowana z nieokreślonego źródła.
SYSTEM_APP_FACTORY_VERSION Jest to aplikacja systemowa z obrazu fabrycznego urządzenia.
SYSTEM_APP_UPDATED_VERSION To 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 jest nieokreś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. 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ść do odczytania przez 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".

Poziom ważności

Poziom ważności 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. Należy ustawiać ją tylko w przypadku rzeczywistych błędów, które wymagają podjęcia działań przez organizację zarządzającą.

UserFacingType

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

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

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

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

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

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.

ActivationState

Stan aktywacji karty SIM na urządzeniu.

Wartości w polu enum
ACTIVATION_STATE_UNSPECIFIED Stan aktywacji nie jest określony.
ACTIVATED Karta SIM jest aktywowana.
NOT_ACTIVATED Karta SIM nie jest aktywowana.

ConfigMode

Tryb konfiguracji karty SIM na urządzeniu.

Wartości w polu enum
CONFIG_MODE_UNSPECIFIED Tryb konfiguracji jest nieokreślony.
ADMIN_CONFIGURED Administrator skonfigurował tę kartę SIM.
USER_CONFIGURED Użytkownik skonfigurował tę kartę SIM.

MemoryInfo

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

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

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

Aby odróżnić nowe i stare zdarzenia, zalecamy używanie pola createTime.

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.

MemoryEventType

Typ zdarzenia.

Wartości w polu enum
MEMORY_EVENT_TYPE_UNSPECIFIED Nie określono. Żadne zdarzenia nie mają tego typu.
RAM_MEASURED Zmierzono ilość wolnego miejsca w pamięci RAM.
INTERNAL_STORAGE_MEASURED Zmierzono ilość wolnego miejsca w pamięci wewnętrznej.
EXTERNAL_STORAGE_DETECTED Wykryto nowy zewnętrzny nośnik danych. Podana liczba bajtów to łączna pojemność nośnika danych.
EXTERNAL_STORAGE_REMOVED Zewnętrzny nośnik danych został usunięty. Zgłoszona liczba bajtów wynosi zero.
EXTERNAL_STORAGE_MEASURED Zmierzono ilość wolnego miejsca na zewnętrznym nośniku danych.

PowerManagementEvent

Zdarzenie zarządzania zasilaniem.

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.

PowerManagementEventType

Typ zdarzenia.

Wartości w polu enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Nie określono. Żadne zdarzenia nie mają tego typu.
BATTERY_LEVEL_COLLECTED Poziom baterii został zmierzony.
POWER_CONNECTED Urządzenie zaczęło się ładować.
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 energii.
BOOT_COMPLETED Urządzenie zostało uruchomione.
SHUTDOWN Urządzenie zostało wyłączone.

HardwareStatus

Stan sprzętu. Temperatury można porównać z progami temperatury dostępnymi w hardwareInfo, aby określić stan sprzętu.

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

string (Timestamp format)

Godzina 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

Bieżące 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 RPM 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

Informacje o ustawieniach urządzenia 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

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.

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 Urządzenie nie obsługuje szyfrowania.
INACTIVE Urządzenie obsługuje szyfrowanie, ale nie jest ono obecnie aktywne.
ACTIVATING Szyfrowanie nie jest obecnie aktywne, ale jest w trakcie aktywacji.
ACTIVE Szyfrowanie jest aktywne.
ACTIVE_DEFAULT_KEY Szyfrowanie jest aktywne, ale klucz szyfrowania nie został ustawiony przez użytkownika.
ACTIVE_PER_USER Szyfrowanie jest aktywne, a klucz szyfrowania jest powiązany z profilem użytkownika.

SecurityPosture

Poziom bezpieczeństwa urządzenia określony na podstawie jego aktualnego 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 o stanie 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 dotyczących tego stanu.
SECURE To urządzenie jest bezpieczne.
AT_RISK To urządzenie może być bardziej podatne na ataki złośliwych podmiotów niż zalecane do używania z danymi firmowymi.
POTENTIALLY_COMPROMISED To urządzenie może być przejęte, a dane firmowe mogą być dostępne dla nieautoryzowanych podmiotów.

PostureDetail

Dodatkowe informacje o stanie zabezpieczeń urządzenia.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

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

SecurityRisk

Ryzyko, które sprawia, że urządzenie nie jest w najbezpieczniejszym 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 basicIntegrity zakończył się powodzeniem, ale test ctsProfileMatch nie).
COMPROMISED_OS Interfejs Play Integrity API wykrywa, że na urządzeniu działa naruszony system operacyjny (test basicIntegrity nie powiódł się).
HARDWARE_BACKED_EVALUATION_FAILED Jeśli w polu integralności urządzenia nie wyświetla się etykieta MEETS_STRONG_INTEGRITY, interfejs Play Integrity API wykrywa, że urządzenie nie ma silnej gwarancji integralności systemu.

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.

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.

CommonCriteriaModeStatus

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

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.

PolicySignatureVerificationStatus

Stan weryfikacji podpisu zasad.

Wartości w polu enum
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Nie określono. Stan weryfikacji nie został zgłoszony. Tę wartość ustawia się tylko wtedy, gdy statusReportingSettings.commonCriteriaModeEnabled ma wartość false.
POLICY_SIGNATURE_VERIFICATION_DISABLED Weryfikacja podpisu zasad jest wyłączona na urządzeniu, ponieważ wartość parametru commonCriteriaMode to „false”.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED Weryfikacja podpisu zasady zakończona.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED Weryfikacja podpisu zasad nie jest obsługiwana, np. dlatego, że urządzenie zostało zarejestrowane w wersji CloudDPC, która nie obsługuje weryfikacji podpisu zasad.
POLICY_SIGNATURE_VERIFICATION_FAILED Nie udało się zweryfikować podpisu zasady. Zasady nie zostały zastosowane.

DpcMigrationInfo

Informacje o tym, czy to urządzenie zostało przeniesione z zarządzania przez innego kontrolera 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 dostawcy DPC, jest to jego nazwa pakietu. W przeciwnym razie 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.

Metody

delete

 Usuwa urządzenie.

get

 Pobiera urządzenie.

issueCommand

 Wydaje polecenie do urządzenia.

list

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

patch

 Aktualizuje urządzenie.