REST Resource: enterprises.devices

Zasób: urządzenie

Urządzenie należące do firmy. O ile nie wskazano inaczej, wszystkie pola są tylko do odczytu i enterprises.devices.patch nie mogą ich modyfikować.

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 będącego właścicielem tego urządzenia w formie enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Typ trybu zarządzania aplikacją Android Device Policy na urządzeniu. Ma to wpływ na obsługiwane ustawienia zasad.
state

enum (DeviceState)

Stan, który ma być stosowany do urządzenia. To pole może zostać zmodyfikowane przez żądanie poprawki. Pamiętaj, że podczas wywoływania funkcji enterprises.devices.patch, ACTIVE i DISABLED są jedynymi dozwolonymi wartościami. Aby wprowadzić stan urządzenia w trybie DELETED, zadzwoń do: enterprises.devices.delete.
appliedState

enum (DeviceState)

Stan aktualnie stosowany do urządzenia.
policyCompliant

boolean

Określa, czy urządzenie jest zgodne z obowiązującymi 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 formacie „Zulu” RFC3339 UTC 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)

Godzina ostatniego wysłania przez urządzenie raportu o stanie.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 formacie „Zulu” RFC3339 UTC 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)

Moment ostatniego pobrania zasad przez urządzenie.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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, w formacie enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie określisz żadnej wartości, zostanie zastosowana policyName dla użytkownika urządzenia. To pole może zostać zmodyfikowane przez żądanie poprawki. Podczas wywoływania funkcji enterprises.devices.patch możesz określić tylko policyId, o ile pole policyId nie zawiera ukośników. Pozostała część nazwy zasady jest określana na podstawie tej informacji.
appliedPolicyName

string

Nazwa zasad obecnie stosowanych na urządzeniu.
appliedPolicyVersion

string (int64 format)

Wersja zasad, 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 jego nazwę.
disabledReason

object (UserFacingMessage)

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

object (SoftwareInfo)

Szczegółowe informacje o oprogramowaniu urządzenia. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada softwareInfoEnabled.
hardwareInfo

object (HardwareInfo)

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

object (Display)

Szczegółowe informacje o ekranach urządzenia. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada displayInfoEnabled.
applicationReports[]

object (ApplicationReport)

Raporty o aplikacjach zainstalowanych na urządzeniu. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia zasada applicationReportsEnabled ma wartość Prawda.
previousDeviceNames[]

string

Jeśli to samo urządzenie fizyczne zostało zarejestrowane wiele razy, to pole zawiera jego wcześniejsze nazwy. Numer seryjny służy jako unikalny identyfikator do określania, czy to samo urządzenie fizyczne zostało wcześniej zarejestrowane. Nazwy są w porządku chronologicznym.
networkInfo

object (NetworkInfo)

Informacje o sieci urządzenia. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada networkInfoEnabled.
memoryInfo

object (MemoryInfo)

Informacje o pamięci: zawiera informacje o pamięci i miejscu na urządzeniu.
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 w zasadzie urządzenia jest włączona zasada memoryInfoEnabled.

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

object (PowerManagementEvent)

Zdarzenia zarządzania zasilaniem na urządzeniu w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada powerManagementEventsEnabled.
hardwareStatusSamples[]

object (HardwareStatus)

Próbki stanu urządzeń w kolejności chronologicznej. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada hardwareStatusEnabled.
deviceSettings

object (DeviceSettings)

Informacje o ustawieniach urządzenia. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada deviceSettingsEnabled.
user

object (User)

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

map (key: string, value: string)

Mapa nazwy i wartości wybranych właściwości systemu z urządzeniem. Te informacje są dostępne tylko wtedy, gdy w zasadzie urządzenia jest włączona zasada systemPropertiesEnabled.

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ść zarządzanego urządzenia.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informacje o trybie Common Criteria – standardami zabezpieczeń określonymi w dokumencie Common Criteria for Information Technology Security Evaluation (CC).

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

object (PasswordRequirements)

Wymagania dotyczące haseł są obecnie stosowane na urządzeniu.

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

object (DpcMigrationInfo)

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

DeviceState

Stany, które mogą być stosowane 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 końcowym raporcie o stanie, gdy urządzenie potwierdzi usunięcie. Jeśli urządzenie zostanie usunięte za pomocą wywołania interfejsu API, ten stan jest publikowany w Pub/Sub. Jeśli użytkownik usunie profil służbowy lub zresetuje urządzenie, stan urządzenia pozostanie nieznany serwerowi.
PROVISIONING Urządzenie jest obsługiwane. Nowo zarejestrowane urządzenia pozostają w tym stanie, dopóki nie zostaną zastosowane zasady.
LOST urządzenie zostało zgubione, Ten stan jest możliwy tylko na urządzeniach należących do organizacji.
PREPARING_FOR_MIGRATION Urządzenie przygotowuje się do migracji do Android Management API. Nie musisz podejmować żadnych działań, aby kontynuować migrację.

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 zasad. To jest nazwa pola JSON najwyższego poziomu Policy.
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 (w stosownych przypadkach).
fieldPath

string

W przypadku ustawień z zagnieżdżonymi polami, jeśli konkretne zagnieżdżone pole jest niezgodne, określa pełną ścieżkę do niewłaściwego pola. Ścieżka jest sformatowana w taki sam sposób, w jaki odwołuje się do pola JSON zasad w kodzie JavaScript, czyli: 1) w przypadku pól typu obiekt nazwa pola zawiera kropkę, a następnie nazwę pola podrzędnego; 2) W przypadku pól tablicowych po nazwie pola następuje indeks tablicy zawarty w nawiasach kwadratowych. Aby np. wskazać problem z polem url w polu externalData w trzeciej aplikacji, użyj ścieżki applications[2].externalData.url
currentValue

value (Value format)

Jeśli nie udało się zastosować ustawienia zasad, jest to jego bieżąca wartość 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, dla którego nie można zainstalować ani zaktualizować aplikacji.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Przyczyna specyficzna dla zasad, dla której urządzenie nie jest zgodne z 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: na urządzeniu jest za mało miejsca, połączenie sieciowe urządzenia jest zawodne lub instalacja trwa dłużej niż oczekiwano. Próba instalacji zostanie ponowiona automatycznie.
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 Brak licencji do przypisania użytkownikowi.
NOT_ENROLLED Grupa dyskusyjna nie jest już zarejestrowana w zarządzanym Sklepie Google Play lub administrator nie zaakceptował najnowszych Warunków korzystania z usługi zarządzanego Sklepu Google Play.
USER_INVALID Użytkownik stracił ważność. 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ę. Dzieje się tak zwykle wtedy, gdy połączenie z internetem na urządzeniu jest pogorszone, niedostępne lub występuje problem z konfiguracją sieci. Upewnij się, że urządzenie ma dostęp do pełnego połączenia 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ę. Ten problem można rozwiązać, 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 tym, dlaczego urządzenie może być niezgodne z ustawieniem zasad. W przyszłości możesz dodawać do tej liczby nowe wartości.

Wartości w polu enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Nie podano konkretnej przyczyny niezgodności. Pola w: specificNonComplianceContext nie zostały ustawione.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Użytkownik musi potwierdzić dane logowania, wpisując blokadę ekranu. Pola w: specificNonComplianceContext nie zostały ustawione. nonComplianceReason ma wartość USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Hasło do urządzenia lub profilu wygasło. Ustawienie passwordPoliciesContext jest ustawione. nonComplianceReason ma wartość USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Hasło urządzenia nie spełnia wymagań dotyczących haseł. Ustawienie passwordPoliciesContext jest ustawione. nonComplianceReason ma wartość USER_ACTION.
ONC_WIFI_INVALID_VALUE Konfiguracja Wi-Fi w ONC ma nieprawidłową wartość. fieldPath określa, która wartość pola jest nieprawidłowa. Ustawienie oncWifiContext jest ustawione. nonComplianceReason ma wartość INVALID_VALUE.
ONC_WIFI_API_LEVEL Ustawienie Wi-Fi ONC nie jest obsługiwane przez poziom API w wersji Androida na urządzeniu. fieldPath określa, która wartość pola nie jest obsługiwana. Ustawienie oncWifiContext jest ustawione. 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 urządzeniach należących do firmy. nonComplianceReason ma wartość USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY Alias pary kluczy określony w polu ClientCertKeyPairAlias w 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 w przypadku niezgodności w konfiguracji Wi-Fi. Zobacz ONC_WIFI_INVALID_VALUE i ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

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

OncWifiContext

Dodatkowy kontekst w przypadku niezgodności w konfiguracji Wi-Fi.

Zapis JSON 
{
  "wifiGuid": string
}
Pola
wifiGuid

string

Identyfikator GUID niezgodnej konfiguracji Wi-Fi.

PasswordPoliciesContext

Dodatkowy kontekst w przypadku 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

Widoczny dla użytkownika ciąg znaków wersji Androida. 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, na przykład 2.6.32.9-g103d848.
bootloaderVersion

string

Numer wersji programu rozruchowego systemu, np. 0.6.7.
androidBuildTime

string (Timestamp format)

Czas kompilacji.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 na urządzeniu.
deviceBuildSignature

string

Skrót SHA-256 obiektu android.content.pm.Signature powiązanego z pakietem systemowym, który może 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: czy aktualizacja istnieje i jaki jest jej typ.
updateReceivedTime

string (Timestamp format)

Godzina pierwszego udostępnienia aktualizacji. Wartość zerowa oznacza, że pole nie zostało 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).

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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: czy aktualizacja istnieje i jaki jest jej typ.

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

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 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 urządzenia.
batteryThrottlingTemperatures[]

number

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

number

Progi temperatury wyłączania procesora wyrażone 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łączenia GPU w stopniach Celsjusza dla każdego GPU w urządzeniu.
gpuThrottlingTemperatures[]

number

Progi ograniczania temperatury przez GPU w stopniach Celsjusza dla każdego GPU w urządzeniu.
skinShutdownTemperatures[]

number

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

number

Progi ograniczania temperatury skóry na urządzeniu w stopniach Celsjusza.
enterpriseSpecificId

string

Tylko dane wyjściowe. Identyfikator, który jednoznacznie identyfikuje urządzenie należące do danej organizacji w konkretnej organizacji. na tym samym urządzeniu fizycznym zarejestrowanym w tej samej organizacji, niezależnie od konfiguracji i przywracania ustawień fabrycznych; Ten identyfikator jest dostępny na należących do firmy urządzeniach z profilem służbowym na urządzeniach z Androidem 12 lub nowszym.

Reklamy displayowe

Informacje wyświetlane na 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 identyfikator reklamy displayowej.
refreshRate

integer

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

enum (DisplayState)

Stan wyświetlacza.
width

integer

Wyświetlaj szerokość w pikselach.
height

integer

Wyświetlaj wysokość w pikselach.
density

integer

Gęstość wyświetlacza wyrażona w kropkach 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 uśpił się przy niskim zużyciu energii
SUSPENDED Wyświetlacz jest drzemiący i ma niski poziom zasilania.

ApplicationReport

Zgłoszone 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, na podstawie którego można określić, czy któraś z wersji 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

Skrót SHA-256 pliku APK aplikacji, który umożliwia sprawdzenie, czy aplikacja nie została zmodyfikowana. Każdy bajt wartości skrótu to 2-cyfrowa liczba szesnastkowa.
signingKeyCertFingerprints[]

string

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

string

Nazwa pakietu aplikacji, z której została zainstalowana.
applicationSource

enum (ApplicationSource)

Źródło pakietu.
state

enum (ApplicationState)

Stan aplikacji.
keyedAppStates[]

object (KeyedAppState)

Lista stanów aplikacji zgłoszonych przez aplikację jako kluczem.
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 zdarzenia.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 aplikacja została zmieniona, np. włączony lub wyłączony komponent;
DATA_CLEARED Dane aplikacji zostały wyczyszczone.
REMOVED Aplikacja została usunięta.
REPLACED Zainstalowano nową wersję 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 podał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 pochodząca 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 jest nieokreślony
REMOVED Aplikacja została usunięta z urządzenia
INSTALLED Aplikacja jest zainstalowana na urządzeniu

KeyedAppState

Raportowany przez aplikację stan aplikacji z kluczem.

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

string

Klucz stanu aplikacji. Działa jako punkt odniesienia dla tego, co podaje aplikacja. Na przykład w przypadku przesyłania opinii na temat konfiguracji zarządzanej tym kluczem może być klucz konfiguracji zarządzanej.
severity

enum (Severity)

Poziom ważności stanu aplikacji.
message

string

Opcjonalnie swobodny ciąg tekstowy z objaśnieniem stanu aplikacji. Jeśli stan został aktywowany przez określoną wartość (np. wartość konfiguracji zarządzanej), powinna ona być uwzględniona w komunikacie.
data

string

Opcjonalnie zrozumiała dla komputera wartość do odczytania przez EMM. Może to być na przykład ustawienie wartości, do których administrator może wysyłać zapytania w konsoli EMM (np. „powiadom mnie, jeśli dane o baterii < 10” będą mniejsze).
createTime

string (Timestamp format)

Czas utworzenia stanu aplikacji na urządzeniu.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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)

Czas ostatniej aktualizacji stanu aplikacji.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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

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. Tę wartość należy ustawić tylko w przypadku rzeczywistych błędów, które organizacja zarządzająca musi podjąć w celu rozwiązania problemu.

UserFacingType

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

Wartości w polu enum
USER_FACING_TYPE_UNSPECIFIED Typ widoczny dla użytkownika aplikacji 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

Alfabetyczna nazwa aktualnie zarejestrowanego operatora. na przykład Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Udostępnia informacje telefoniczne powiązane z każdą kartą SIM w urządzeniu. Obsługiwane tylko na w pełni zarządzanych urządzeniach od poziomu interfejsu Android API 23.

TelephonyInfo

Informacje o połączeniach telefonicznych powiązane z daną kartą SIM w urządzeniu. Obsługiwane tylko na w pełni zarządzanych urządzeniach od poziomu interfejsu Android API 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 na urządzeniu (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 zdarzenia.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 lub w przypadku EXTERNAL_STORAGE_DETECTED łączna pojemność w bajtach medium pamięci masowej.

MemoryEventType

Typ zdarzenia.

Wartości w polu enum
MEMORY_EVENT_TYPE_UNSPECIFIED Nie określono. Brak wydarzeń tego typu.
RAM_MEASURED Zmierzono wolne miejsce w pamięci RAM.
INTERNAL_STORAGE_MEASURED Zmierzono ilość wolnego miejsca w pamięci wewnętrznej.
EXTERNAL_STORAGE_DETECTED Wykryto nowe nośnik pamięci zewnętrznej. Raportowana liczba bajtów to całkowity rozmiar medium pamięci masowej.
EXTERNAL_STORAGE_REMOVED Usunięto nośnik pamięci zewnętrznej. Raportowana liczba bajtów wynosi zero.
EXTERNAL_STORAGE_MEASURED Zmierzono ilość wolnego miejsca na nośniku pamięci zewnętrznej.

PowerManagementEvent

Zdarzenie zarządzania energią.

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

enum (PowerManagementEventType)

Typ zdarzenia.
createTime

string (Timestamp format)

Czas utworzenia zdarzenia.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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ń BATTERY_LEVEL_COLLECTED poziom baterii jest wyrażony procentowo.

PowerManagementEventType

Typ zdarzenia.

Wartości w polu enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Nie określono. Brak wydarzeń tego typu.
BATTERY_LEVEL_COLLECTED Zmierzono poziom naładowania baterii.
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 uruchomiło się.
SHUTDOWN Urządzenie się wyłączyło.

HardwareStatus

Stan sprzętu. Aby określić stan sprzętu, temperatury można porównywać z progami temperatur dostępnymi w hardwareInfo.

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 formacie „Zulu” RFC3339 UTC 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

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

number

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

number

Bieżąca temperatura GPU w stopniach Celsjusza dla każdego GPU w urządzeniu.
skinTemperatures[]

number

Bieżąca temperatura skóry na urządzeniu w stopniach Celsjusza.
fanSpeeds[]

number

Szybkość wentylatora w RPM dla każdego wentylatora urządzenia. Pusta tablica oznacza, że system nie ma wentylatorów lub prędkość wentylatora nie jest obsługiwana.
cpuUsages[]

number

Wyrażone procentowo wykorzystanie procesora na każdy rdzeń dostępny na urządzeniu. Wykorzystanie wynosi 0 dla każdego odłączonego rdzenia. Pusta tablica oznacza, że wykorzystanie procesora nie jest obsługiwane przez system.

DeviceSettings

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

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 włączony jest tryb programisty.
adbEnabled

boolean

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

boolean

Określa, czy szyfrowanie miejsca na dane 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 właśnie trwa.
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 bieżącego stanu urządzenia 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 stanu dla tej wartości stanu.
SECURE To urządzenie jest bezpieczne.
AT_RISK To urządzenie może być bardziej narażone na szkodliwe ataki, niż jest zalecane do używania z danymi firmowymi.
POTENTIALLY_COMPROMISED To urządzenie mogło zostać przejęte, a dane firmowe mogą być dostępne dla nieautoryzowanych osób.

PostureDetail

Dodatkowe informacje o stanie zabezpieczeń urządzenia.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

Porady dla administratora dotyczące ograniczania tego zagrożenia i poprawy stanu zabezpieczeń urządzenia.

SecurityRisk

Ryzyko powodujące, ż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 wykrył, że na urządzeniu jest nieznany system operacyjny (podstawowa kontrola integralności zakończy się powodzeniem, ale test ctsProfileMatch się nie powiedzie).
COMPROMISED_OS Interfejs Play Integrity API wykrył, że na urządzeniu działa przejęty system operacyjny (podstawowa kontrola integralności kończy się niepowodzeniem).
HARDWARE_BACKED_EVALUATION_FAILED Interfejs Play Integrity API wykryje, że urządzenie nie ma silnej gwarancji integralności systemu, jeśli etykieta MEETS_STRONG_INTEGRITY nie wyświetla się w polu integralności urządzenia.

CommonCriteriaModeInfo

Informacje o trybie Common Criteria – standardami zabezpieczeń określonymi w dokumencie Common Criteria for Information Technology Security Evaluation (CC).

Te informacje są dostępne tylko wtedy, gdy w zasadach urządzenia dotyczących 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 dotyczące tego, czy to urządzenie zostało przeniesione z zarządzania 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 kontrolera DPC, jest to nazwa jego pakietu. W przeciwnym razie nie będzie wypełnione.
additionalData

string

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

Metody

delete

 Usuwa urządzenie.

get

 Pobiera urządzenie.

issueCommand

 Wydaje polecenie na urządzeniu.

list

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

patch

 Aktualizuje urządzenie.