REST Resource: enterprises.devices

Ресурс: Устройство

Устройство, принадлежащее предприятию. Если не указано иное, все поля доступны только для чтения и не могут быть изменены enterprises.devices.patch .

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)
  }
}
Поля
name

string

Имя устройства в формате enterprises/{enterpriseId}/devices/{deviceId} .

userName

string

Имя ресурса пользователя, которому принадлежит это устройство, в форме enterprises/{enterpriseId}/users/{userId} .

managementMode

enum ( ManagementMode )

Тип режима управления, который Android Device Policy принимает на устройстве. Это влияет на то, какие параметры политики поддерживаются.

state

enum ( DeviceState )

Состояние, которое будет применено к устройству. Это поле может быть изменено запросом на исправление. Обратите внимание, что при вызове enterprises.devices.patch допустимыми значениями являются только ACTIVE и DISABLED . Чтобы перевести устройство в состояние DELETED , вызовите enterprises.devices.delete .

appliedState

enum ( DeviceState )

Состояние, применяемое в данный момент к устройству.

policyCompliant

boolean

Соответствует ли устройство его политике.

nonComplianceDetails[]

object ( NonComplianceDetail )

Подробная информация о параметрах политики, которым не соответствует устройство.

enrollmentTime

string ( Timestamp format)

Время регистрации устройства.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastStatusReportTime

string ( Timestamp format)

Последний раз, когда устройство отправляло отчет о состоянии.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastPolicyComplianceReportTime
(deprecated)

string ( Timestamp format)

Устарело.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastPolicySyncTime

string ( Timestamp format)

Последний раз, когда устройство извлекало свою политику.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

policyName

string

Имя политики, примененной к устройству, в форме enterprises/{enterpriseId}/policies/{policyId} . Если не указано, применяется policyName для пользователя устройства. Это поле можно изменить с помощью запроса на исправление. При вызове enterprises.devices.patch можно указать только policyId , если policyId не содержит слешей. Остальная часть имени политики выводится.

appliedPolicyName

string

Название политики, применяемой в данный момент к устройству.

appliedPolicyVersion

string ( int64 format)

Версия политики, применяемой в данный момент к устройству.

apiLevel

integer

Уровень API версии платформы Android, работающей на устройстве.

enrollmentTokenData

string

Если устройство было зарегистрировано с помощью токена регистрации с дополнительными данными, это поле содержит эти данные.

enrollmentTokenName

string

Если устройство было зарегистрировано с помощью токена регистрации, это поле содержит имя токена.

disabledReason

object ( UserFacingMessage )

Если состояние устройства DISABLED , необязательное сообщение, которое отображается на устройстве, указывающее причину отключения устройства. Это поле может быть изменено запросом на исправление.

softwareInfo

object ( SoftwareInfo )

Подробная информация о программном обеспечении устройства. Эта информация доступна только в том случае, если в политике устройства softwareInfoEnabled имеет значение true.

hardwareInfo

object ( HardwareInfo )

Подробная информация об аппаратной части устройства.

displays[]

object ( Display )

Подробная информация о дисплеях на устройстве. Эта информация доступна только если displayInfoEnabled имеет значение true в политике устройства.

applicationReports[]

object ( ApplicationReport )

Отчеты для приложений, установленных на устройстве. Эта информация доступна только в том случае, если applicationReportsEnabled имеет значение true в политике устройства.

previousDeviceNames[]

string

Если одно и то же физическое устройство было зарегистрировано несколько раз, это поле содержит его предыдущие имена устройств. Серийный номер используется как уникальный идентификатор для определения того, было ли это же физическое устройство зарегистрировано ранее. Имена указаны в хронологическом порядке.

networkInfo

object ( NetworkInfo )

Информация о сети устройства. Эта информация доступна только в том случае, если networkInfoEnabled имеет значение true в политике устройства.

memoryInfo

object ( MemoryInfo )

Информация о памяти: содержит информацию о памяти устройства и хранилище.

memoryEvents[]

object ( MemoryEvent )

События, связанные с измерениями памяти и хранилища в хронологическом порядке. Эта информация доступна только в том случае, если memoryInfoEnabled имеет значение true в политике устройства.

События сохраняются в течение определенного периода времени, а старые события удаляются.

powerManagementEvents[]

object ( PowerManagementEvent )

События управления питанием на устройстве в хронологическом порядке. Эта информация доступна только в том случае, если powerManagementEventsEnabled имеет значение true в политике устройства.

hardwareStatusSamples[]

object ( HardwareStatus )

Образцы состояния оборудования в хронологическом порядке. Эта информация доступна только в том случае, если hardwareStatusEnabled имеет значение true в политике устройства.

deviceSettings

object ( DeviceSettings )

Информация о настройках устройства. Эта информация доступна только в том случае, если deviceSettingsEnabled имеет значение true в политике устройства.

user

object ( User )

Пользователь, которому принадлежит устройство.

systemProperties

map (key: string, value: string)

Карта выбранных системных свойств имени и значения, связанных с устройством. Эта информация доступна только в том случае, если systemPropertiesEnabled имеет значение true в политике устройства.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

securityPosture

object ( SecurityPosture )

Значение уровня безопасности устройства, отражающее, насколько оно защищено.

ownership

enum ( Ownership )

Право собственности на управляемое устройство.

commonCriteriaModeInfo

object ( CommonCriteriaModeInfo )

Информация о режиме общих критериев — стандартах безопасности, определенных в Общих критериях оценки безопасности информационных технологий (CC).

Эта информация доступна только в том случае, если в политике устройства statusReportingSettings.commonCriteriaModeEnabled имеет значение true , если устройство принадлежит компании.

appliedPasswordPolicies[]

object ( PasswordRequirements )

Требования к паролю, применяемые в настоящее время к устройству.

  • В некоторых случаях применяемые требования могут немного отличаться от указанных в passwordPolicies .
  • fieldPath задается на основе passwordPolicies .
dpcMigrationInfo

object ( DpcMigrationInfo )

Только вывод. Информация о том, было ли это устройство перенесено из-под управления другим контроллером политики устройств (DPC).

Состояние устройства

Состояния, которые могут быть применены к устройству.

Перечисления
DEVICE_STATE_UNSPECIFIED Это значение недопустимо.
ACTIVE Устройство активно.
DISABLED Устройство отключено.
DELETED Устройство было удалено. Это состояние никогда не возвращается вызовом API, но используется в окончательном отчете о состоянии, когда устройство подтверждает удаление. Если устройство удаляется через вызов API, это состояние публикуется в Pub/Sub. Если пользователь удаляет рабочий профиль или сбрасывает устройство, состояние устройства останется неизвестным серверу.
PROVISIONING Устройство находится в процессе подготовки. Вновь зарегистрированные устройства находятся в этом состоянии, пока к ним не будет применена политика.
LOST Устройство потеряно. Это состояние возможно только на устройствах, принадлежащих организации.
PREPARING_FOR_MIGRATION Устройство готовится к миграции на Android Management API. Для продолжения миграции не требуется никаких дополнительных действий.
DEACTIVATED_BY_DEVICE_FINANCE Это финансируемое устройство, которое было «заблокировано» финансовым агентом. Это означает, что были применены определенные параметры политики, которые ограничивают функциональность устройства до тех пор, пока устройство не будет «разблокировано» финансовым агентом. Устройство продолжит применять параметры политики, за исключением тех, которые были переопределены финансовым агентом. Когда устройство «заблокировано», состояние отображается в appliedState как DEACTIVATED_BY_DEVICE_FINANCE .

НесоответствиеПодробно

Предоставляет подробную информацию о несоблюдении параметров политики.

JSON-представление 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Поля
settingName

string

Имя параметра политики. Это имя поля JSON поля Policy верхнего уровня.

nonComplianceReason

enum ( NonComplianceReason )

Причина, по которой устройство не соответствует настройке.

packageName

string

Имя пакета, указывающее, какое приложение не соответствует требованиям, если применимо.

fieldPath

string

Для настроек с вложенными полями, если определенное вложенное поле не соответствует требованиям, это указывает полный путь к полю-нарушителю. Путь форматируется так же, как поле политики JSON будет указано в JavaScript, то есть: 1) Для полей объектного типа за именем поля следует точка, а затем имя подполя. 2) Для полей массивного типа за именем поля следует индекс массива, заключенный в скобки. Например, чтобы указать на проблему с полем url в поле externalData в 3-м приложении, путь будет applications[2].externalData.url

currentValue

value ( Value format)

Если параметр политики не может быть применен, текущее значение параметра на устройстве.

installationFailureReason

enum ( InstallationFailureReason )

Если задано packageName и причиной несоответствия является APP_NOT_INSTALLED или APP_NOT_UPDATED , подробная причина, по которой приложение не может быть установлено или обновлено.

specificNonComplianceReason

enum ( SpecificNonComplianceReason )

Причина, по которой устройство не соответствует настройкам политики.

specificNonComplianceContext

object ( SpecificNonComplianceContext )

Дополнительный контекст для specificNonComplianceReason .

Причина сбоя установки

Причины, по которым установка приложения может завершиться неудачей.

Перечисления
INSTALLATION_FAILURE_REASON_UNSPECIFIED Это значение недопустимо.
INSTALLATION_FAILURE_REASON_UNKNOWN Неизвестное условие препятствует установке приложения. Возможные причины: на устройстве недостаточно памяти, сетевое подключение устройства ненадежно или установка занимает больше времени, чем ожидалось. Установка будет повторена автоматически.
IN_PROGRESS Установка все еще продолжается.
NOT_FOUND Приложение не найдено в Play.
NOT_COMPATIBLE_WITH_DEVICE Приложение несовместимо с устройством.
NOT_APPROVED Приложение не одобрено администратором.
PERMISSIONS_NOT_ACCEPTED У приложения есть новые разрешения, которые не были приняты администратором.
NOT_AVAILABLE_IN_COUNTRY Приложение недоступно в стране пользователя.
NO_LICENSES_REMAINING Нет лицензий, доступных для назначения пользователю.
NOT_ENROLLED Предприятие больше не зарегистрировано в Managed Google Play, или администратор не принял последние Условия обслуживания Managed Google Play.
USER_INVALID Пользователь больше не действителен. Пользователь мог быть удален или отключен.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Сетевая ошибка на устройстве пользователя помешала успешной установке. Обычно это происходит, когда интернет-подключение устройства ухудшилось, недоступно или возникла проблема с конфигурацией сети. Убедитесь, что устройство имеет доступ к полному интернет-подключению в сети, которая соответствует Android Enterprise Network Requirements . Установка или обновление приложения автоматически возобновятся, как только это произойдет.

INSUFFICIENT_STORAGE На устройстве пользователя недостаточно места для установки приложения. Эту проблему можно решить, очистив место на устройстве. Установка или обновление приложения автоматически возобновятся, как только на устройстве будет достаточно места.

КонкретнаяПричинаНесоблюдения

Дополнительные сведения о причине, по которой устройство может не соответствовать параметру политики. Новые значения могут быть добавлены в перечисление в будущем.

Перечисления
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Конкретная причина несоответствия не указана. Поля в specificNonComplianceContext не заданы.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Пользователь должен подтвердить учетные данные, введя блокировку экрана. Поля в specificNonComplianceContext не заданы. nonComplianceReason задан как USER_ACTION .
PASSWORD_POLICIES_PASSWORD_EXPIRED Срок действия пароля устройства или профиля истек. Задается passwordPoliciesContext . nonComplianceReason задается в USER_ACTION .
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Пароль устройства не удовлетворяет требованиям к паролю. Задан passwordPoliciesContext . nonComplianceReason установлен в USER_ACTION .
ONC_WIFI_INVALID_VALUE В конфигурации ONC Wi-Fi указано неверное значение. fieldPath указывает, какое значение поля неверно. oncWifiContext задан. nonComplianceReason задано как INVALID_VALUE .
ONC_WIFI_API_LEVEL Параметр ONC Wi-Fi не поддерживается на уровне API версии Android, работающей на устройстве. fieldPath указывает, какое значение поля не поддерживается. oncWifiContext задан. nonComplianceReason задан как API_LEVEL .
ONC_WIFI_INVALID_ENTERPRISE_CONFIG В корпоративной сети Wi-Fi отсутствует корневой центр сертификации или доменное имя. nonComplianceReason имеет значение INVALID_VALUE .
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK Пользователь должен вручную удалить настроенную сеть Wi-Fi. Это применимо только к рабочим профилям на личных устройствах. nonComplianceReason установлен на USER_ACTION .
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY Псевдоним пары ключей, указанный через поле ClientCertKeyPairAlias ​​в openNetworkConfiguration , не соответствует существующему ключу, установленному на устройстве. nonComplianceReason имеет значение INVALID_VALUE .
PERMISSIBLE_USAGE_RESTRICTION Этот параметр политики ограничен и не может быть установлен для этого проекта Google Cloud Platform. Дополнительные сведения (включая то, как включить использование этого параметра политики) доступны в политике Permissible Usage . nonComplianceReason установлен на PROJECT_NOT_PERMITTED .
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE Рабочая учетная запись, требуемая параметром политики workAccountSetupConfig , больше не является частью предприятия. nonComplianceReason имеет значение USER_ACTION .
NEW_ACCOUNT_NOT_IN_ENTERPRISE Рабочая учетная запись, добавленная пользователем, не является частью предприятия. nonComplianceReason имеет значение USER_ACTION .

КонкретныйКонтекстНесоблюдения

Дополнительный контекст для SpecificNonComplianceReason .

JSON-представление 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Поля
oncWifiContext

object ( OncWifiContext )

Дополнительный контекст для несоответствия, связанного с конфигурацией Wi-Fi. См. ONC_WIFI_INVALID_VALUE и ONC_WIFI_API_LEVEL

passwordPoliciesContext

object ( PasswordPoliciesContext )

Дополнительный контекст для несоответствия, связанного с политикой паролей. См. PASSWORD_POLICIES_PASSWORD_EXPIRED и PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT .

OncWifiContext

Дополнительный контекст для несоответствий, связанных с конфигурацией Wi-Fi.

JSON-представление 
{
  "wifiGuid": string
}
Поля
wifiGuid

string

GUID несовместимой конфигурации Wi-Fi.

ПарольПолитикиКонтекст

Дополнительный контекст несоблюдения политики паролей.

JSON-представление 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Поля
passwordPolicyScope

enum ( PasswordPolicyScope )

Область действия несоответствующего пароля.

SoftwareInfo

Информация о программном обеспечении устройства.

JSON-представление 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Поля
androidVersion

string

Видимая пользователем строка версии Android. Например, 6.0.1 .

androidDevicePolicyVersionCode

integer

Код версии приложения Android Device Policy.

androidDevicePolicyVersionName

string

Версия приложения Android Device Policy, отображаемая пользователю.

androidBuildNumber

string

Строка идентификатора сборки Android, предназначенная для отображения пользователю. Например, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys .

deviceKernelVersion

string

Версия ядра, например, 2.6.32.9-g103d848 .

bootloaderVersion

string

Номер версии загрузчика системы, например 0.6.7 .

androidBuildTime

string ( Timestamp format)

Время сборки.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

securityPatchLevel

string

Уровень исправления безопасности, например, 2016-05-01 .

primaryLanguageCode

string

Код языка IETF BCP 47 для основного региона устройства.

deviceBuildSignature

string

SHA-256-хэш android.content.pm.Signature , связанный с системным пакетом, который можно использовать для проверки того, что сборка системы не была изменена.

systemUpdateInfo

object ( SystemUpdateInfo )

Информация о потенциальном ожидаемом обновлении системы.

SystemUpdateInfo

Информация о потенциальном ожидаемом обновлении системы.

JSON-представление 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Поля
updateStatus

enum ( UpdateStatus )

Статус обновления: существует ли обновление и каков его тип.

updateReceivedTime

string ( Timestamp format)

Время, когда обновление было впервые доступно. Нулевое значение указывает на то, что это поле не установлено. Это поле устанавливается только в том случае, если обновление доступно (то есть updateStatus не является ни UPDATE_STATUS_UNKNOWN , ни UP_TO_DATE ).

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

ОбновлениеСтатуса

Статус обновления: существует ли обновление и каков его тип.

Перечисления
UPDATE_STATUS_UNKNOWN Неизвестно, есть ли ожидающее обновление системы. Это происходит, когда, например, уровень API устройства меньше 26 или версия Android Device Policy устарела.
UP_TO_DATE На устройстве нет доступных обновлений системы.
UNKNOWN_UPDATE_AVAILABLE Доступно ожидающее обновления системы, но его тип неизвестен.
SECURITY_UPDATE_AVAILABLE Доступно ожидающее обновления безопасности.
OS_UPDATE_AVAILABLE Доступно ожидающее обновления ОС.

Информация об оборудовании

Информация об оборудовании устройства. Поля, связанные с пороговыми значениями температуры, доступны только в том случае, если hardwareStatusEnabled имеет значение true в политике устройства.

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)
    }
  ]
}
Поля
brand

string

Марка устройства. Например, Google .

hardware

string

Название оборудования. Например, Angler .

deviceBasebandVersion

string

Версия базовой полосы. Например, MDM9625_104662.22.05.34p .

manufacturer

string

Производитель. Например, Motorola .

serialNumber

string

Серийный номер устройства.

model

string

Модель устройства. Например, Asus Nexus 7 .

batteryShutdownTemperatures[]

number

Пороговые значения температуры отключения аккумулятора в градусах Цельсия для каждого аккумулятора на устройстве.

batteryThrottlingTemperatures[]

number

Пороговые значения температуры регулирования батареи в градусах Цельсия для каждой батареи на устройстве.

cpuShutdownTemperatures[]

number

Пороговые значения температуры отключения ЦП в градусах Цельсия для каждого ЦП на устройстве.

cpuThrottlingTemperatures[]

number

Пороговые значения температуры троттлинга ЦП в градусах Цельсия для каждого ЦП на устройстве.

gpuShutdownTemperatures[]

number

Пороговые значения температуры отключения графического процессора в градусах Цельсия для каждого графического процессора на устройстве.

gpuThrottlingTemperatures[]

number

Пороговые значения температуры дросселирования графического процессора в градусах Цельсия для каждого графического процессора на устройстве.

skinShutdownTemperatures[]

number

Пороговые значения температуры отключения оболочки устройства в градусах Цельсия.

skinThrottlingTemperatures[]

number

Пороговые значения температуры дросселирования поверхности устройства в градусах Цельсия.

enterpriseSpecificId

string

Только вывод. Идентификатор, который однозначно идентифицирует личное устройство в определенной организации. На одном и том же физическом устройстве, зарегистрированном в одной и той же организации, этот идентификатор сохраняется при настройках и даже сбросе настроек к заводским. Этот идентификатор доступен на личных устройствах с рабочим профилем на устройствах под управлением Android 12 и выше.

euiccChipInfo[]

object ( EuiccChipInfo )

Только вывод. Информация, связанная с чипом eUICC.

EuiccChipInfo

Информация, связанная с чипом eUICC.

JSON-представление 
{
  "eid": string
}
Поля
eid

string

Только вывод. Встроенный идентификационный документ (EID), который идентифицирует чип eUICC для каждого чипа eUICC на устройстве. Это доступно на корпоративных устройствах под управлением Android 13 и выше.

Отображать

Информация об отображении устройства.

JSON-представление 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Поля
name

string

Название дисплея.

displayId

integer

Уникальный идентификатор дисплея.

refreshRate

integer

Частота обновления дисплея в кадрах в секунду.

state

enum ( DisplayState )

Состояние дисплея.

width

integer

Ширина отображения в пикселях.

height

integer

Отображает высоту в пикселях.

density

integer

Плотность отображения выражается в точках на дюйм.

DisplayState

Состояние дисплея.

Перечисления
DISPLAY_STATE_UNSPECIFIED Это значение недопустимо.
OFF Дисплей выключен.
ON Дисплей включен.
DOZE Дисплей дремлет в состоянии низкого энергопотребления
SUSPENDED Дисплей находится в состоянии ожидания с низким энергопотреблением.

ПриложениеОтчет

Сообщается информация об установленном приложении.

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)
}
Поля
packageName

string

Имя пакета приложения.

versionName

string

Версия приложения, отображаемая пользователю.

versionCode

integer

Код версии приложения, который можно использовать для определения того, является ли одна версия более новой, чем другая.

events[]

object ( ApplicationEvent )

Список событий приложения, произошедших за последние 30 часов.

displayName

string

Отображаемое имя приложения.

packageSha256Hash

string

SHA-256 хэш файла APK приложения, который можно использовать для проверки того, что приложение не было изменено. Каждый байт хэш-значения представлен как двузначное шестнадцатеричное число.

signingKeyCertFingerprints[]

string

SHA-1 хэш каждого android.content.pm.Signature , связанного с пакетом приложения. Каждый байт каждого значения хэша представлен как двузначное шестнадцатеричное число.

installerPackageName

string

Имя пакета приложения, установившего это приложение.

applicationSource

enum ( ApplicationSource )

Источник пакета.

state

enum ( ApplicationState )

Состояние приложения.

keyedAppStates[]

object ( KeyedAppState )

Список ключевых состояний приложения, сообщенных приложением.

userFacingType

enum ( UserFacingType )

Является ли приложение ориентированным на пользователя.

ПриложениеEvent

Событие, связанное с приложением.

JSON-представление 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Поля
eventType

enum ( ApplicationEventType )

Тип события приложения.

createTime

string ( Timestamp format)

Время создания события.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

ApplicationEventType

Тип события, связанного с приложением.

Перечисления
APPLICATION_EVENT_TYPE_UNSPECIFIED Это значение недопустимо.
INSTALLED Приложение установлено.
CHANGED Приложение было изменено, например, компонент был включен или отключен.
DATA_CLEARED Данные приложения были очищены.
REMOVED Приложение было удалено.
REPLACED Установлена ​​новая версия приложения, заменившая старую версию.
RESTARTED Приложение было перезапущено.
PINNED Приложение было закреплено на переднем плане.
UNPINNED Приложение было откреплено.

Источник приложения

Источник, предоставивший приложение.

Перечисления
APPLICATION_SOURCE_UNSPECIFIED Приложение было загружено из неизвестного источника.
SYSTEM_APP_FACTORY_VERSION Это системное приложение из заводского образа устройства.
SYSTEM_APP_UPDATED_VERSION Это обновленное системное приложение.
INSTALLED_FROM_PLAY_STORE Приложение установлено из Google Play Store.

ApplicationState

Текущий статус установки.

Перечисления
APPLICATION_STATE_UNSPECIFIED Состояние приложения не указано
REMOVED Приложение было удалено с устройства.
INSTALLED Приложение установлено на устройстве

KeyedAppState

Состояние ключевого приложения, сообщенное приложением.

JSON-представление 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Поля
key

string

Ключ для состояния приложения. Действует как точка отсчета для того, для чего приложение предоставляет состояние. Например, при предоставлении обратной связи управляемой конфигурации этот ключ может быть ключом управляемой конфигурации.

severity

enum ( Severity )

Серьезность состояния приложения.

message

string

Необязательно, строка сообщения в свободной форме для объяснения состояния приложения. Если состояние было вызвано определенным значением (например, управляемым значением конфигурации), оно должно быть включено в сообщение.

data

string

Необязательно, машиночитаемое значение, которое будет считываться EMM. Например, установка значений, которые администратор может выбрать для запроса в консоли EMM (например, «уведомить меня, если данные battery_warning < 10»).

createTime

string ( Timestamp format)

Время создания состояния приложения на устройстве.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastUpdateTime

string ( Timestamp format)

Время последнего обновления состояния приложения.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Серьёзность

Серьезность состояния приложения.

Перечисления
SEVERITY_UNSPECIFIED Уровень серьезности не указан.
INFO Уровень серьезности информации.
ERROR Уровень серьезности ошибки. Его следует устанавливать только для реальных условий ошибки, для исправления которых управляющей организации необходимо предпринять действия.

UserFacingType

Является ли приложение ориентированным на пользователя.

Перечисления
USER_FACING_TYPE_UNSPECIFIED Тип приложения, к которому обращается пользователь, не указан.
NOT_USER_FACING Приложение не ориентировано на пользователя.
USER_FACING Приложение ориентировано на пользователя.

Информация о сети

Информация о сети устройства.

JSON-представление 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Поля
imei

string

Номер IMEI GSM-устройства. Например, A1000031212 .

meid

string

Номер MEID устройства CDMA. Например, A00000292788E1 .

wifiMacAddress

string

MAC-адрес Wi-Fi устройства. Например, 7c:11:11:11:11:11 .

networkOperatorName
(deprecated)

string

Буквенное название текущего зарегистрированного оператора. Например, Vodafone.

telephonyInfos[]

object ( TelephonyInfo )

Предоставляет информацию о телефонии, связанную с каждой SIM-картой на устройстве. Поддерживается только на полностью управляемых устройствах, начиная с Android API уровня 23.

ТелефонияИнформация

Информация о телефонии, связанная с данной SIM-картой на устройстве. Поддерживается только на полностью управляемых устройствах, начиная с Android API уровня 23.

JSON-представление 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Поля
phoneNumber

string

Номер телефона, связанный с этой SIM-картой.

carrierName

string

Название оператора, связанного с этой SIM-картой.

iccId

string

Только вывод. ICCID, связанный с этой SIM-картой.

activationState

enum ( ActivationState )

Только вывод. Состояние активации SIM-карты на устройстве. Это применимо только для eSIM. Это поддерживается на всех устройствах для уровня API 35 и выше. Это всегда ACTIVATION_STATE_UNSPECIFIED для физических SIM-карт и для устройств ниже уровня API 35.

configMode

enum ( ConfigMode )

Только вывод. Режим конфигурации SIM-карты на устройстве. Применимо только для eSIM. Поддерживается на всех устройствах для уровня API 35 и выше. Всегда CONFIG_MODE_UNSPECIFIED для физических SIM-карт и для устройств ниже уровня API 35.

СостояниеАктивации

Состояние активации SIM-карты на устройстве.

Перечисления
ACTIVATION_STATE_UNSPECIFIED Состояние активации не указано.
ACTIVATED SIM-карта активирована.
NOT_ACTIVATED SIM-карта не активирована.

Режим конфигурации

Режим настройки SIM-карты на устройстве.

Перечисления
CONFIG_MODE_UNSPECIFIED Режим конфигурации не указан.
ADMIN_CONFIGURED Администратор настроил эту SIM-карту.
USER_CONFIGURED Пользователь настроил эту SIM-карту.

ПамятьИнформация

Информация о памяти устройства и хранилище.

JSON-представление 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Поля
totalRam

string ( int64 format)

Общий объем оперативной памяти на устройстве в байтах.

totalInternalStorage

string ( int64 format)

Общий объем внутренней памяти устройства в байтах.

ПамятьСобытие

Событие, связанное с измерениями памяти и хранилища.

Чтобы различать новые и старые события, мы рекомендуем использовать поле createTime .

JSON-представление 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Поля
eventType

enum ( MemoryEventType )

Тип события.

createTime

string ( Timestamp format)

Время создания события.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

byteCount

string ( int64 format)

Количество свободных байтов на носителе или для EXTERNAL_STORAGE_DETECTED общая емкость в байтах носителя.

MemoryEventType

Тип мероприятия.

Перечисления
MEMORY_EVENT_TYPE_UNSPECIFIED Не указано. Нет событий такого типа.
RAM_MEASURED Измерялось свободное место в оперативной памяти.
INTERNAL_STORAGE_MEASURED Измерялось свободное пространство во внутренней памяти.
EXTERNAL_STORAGE_DETECTED Обнаружен новый внешний носитель информации. Сообщенное количество байтов — это общая емкость носителя информации.
EXTERNAL_STORAGE_REMOVED Внешний носитель информации был удален. Сообщенное количество байт равно нулю.
EXTERNAL_STORAGE_MEASURED Измерялось свободное пространство на внешнем носителе информации.

PowerManagementEvent

Событие по управлению питанием.

JSON-представление 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Поля
eventType

enum ( PowerManagementEventType )

Тип события.

createTime

string ( Timestamp format)

Время создания события.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

batteryLevel

number

Для событий BATTERY_LEVEL_COLLECTED — уровень заряда батареи в процентах.

PowerManagementEventType

Тип мероприятия.

Перечисления
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Не указано. Нет событий такого типа.
BATTERY_LEVEL_COLLECTED Уровень заряда батареи был измерен.
POWER_CONNECTED Устройство начало заряжаться.
POWER_DISCONNECTED Устройство перестало заряжаться.
BATTERY_LOW Устройство перешло в режим пониженного энергопотребления.
BATTERY_OKAY Устройство вышло из режима пониженного энергопотребления.
BOOT_COMPLETED Устройство загрузилось.
SHUTDOWN Устройство выключилось.

Состояние оборудования

Состояние оборудования. Температуры можно сравнивать с пороговыми значениями температуры, доступными в hardwareInfo для определения состояния оборудования.

JSON-представление 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Поля
createTime

string ( Timestamp format)

Время проведения измерений.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

batteryTemperatures[]

number

Текущая температура аккумулятора в градусах Цельсия для каждого аккумулятора на устройстве.

cpuTemperatures[]

number

Текущая температура процессора в градусах Цельсия для каждого процессора на устройстве.

gpuTemperatures[]

number

Текущая температура графического процессора в градусах Цельсия для каждого графического процессора на устройстве.

skinTemperatures[]

number

Текущая температура кожи устройства в градусах Цельсия.

fanSpeeds[]

number

Скорость вращения вентилятора в об/мин для каждого вентилятора на устройстве. Пустой массив означает, что вентиляторов нет или скорость вращения вентилятора не поддерживается в системе.

cpuUsages[]

number

Использование ЦП в процентах для каждого ядра, доступного на устройстве. Использование равно 0 для каждого отключенного ядра. Пустой массив означает, что использование ЦП не поддерживается в системе.

Настройки устройства

Информация о настройках устройства, связанных с безопасностью.

JSON-представление 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Поля
isDeviceSecure

boolean

Защищено ли устройство PIN-кодом/паролем.

unknownSourcesEnabled

boolean

Разрешена ли установка приложений из неизвестных источников.

developmentSettingsEnabled

boolean

Включен ли на устройстве режим разработчика.

adbEnabled

boolean

Включен ли ADB на устройстве.

isEncrypted

boolean

Включено ли шифрование хранилища.

encryptionStatus

enum ( EncryptionStatus )

Статус шифрования из DevicePolicyManager.

verifyAppsEnabled

boolean

Применяется ли на устройстве проверка Google Play Protect .

СтатусШифрования

Статус шифрования устройства.

Перечисления
ENCRYPTION_STATUS_UNSPECIFIED Не указано. Ни одно устройство не должно иметь этот тип.
UNSUPPORTED Устройство не поддерживает шифрование.
INACTIVE Шифрование поддерживается устройством, но в данный момент неактивно.
ACTIVATING Шифрование в настоящее время неактивно, но в настоящее время активируется.
ACTIVE Шифрование активно.
ACTIVE_DEFAULT_KEY Шифрование активно, но ключ шифрования пользователем не установлен.
ACTIVE_PER_USER Шифрование активно, а ключ шифрования привязан к профилю пользователя.

БезопасностьПостура

Уровень безопасности устройства, определяемый текущим состоянием устройства и применяемыми политиками.

JSON-представление 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Поля
devicePosture

enum ( DevicePosture )

Значение уровня безопасности устройства.

postureDetails[]

object ( PostureDetail )

Дополнительные сведения о степени безопасности устройства.

УстройствоПоза

Возможные значения уровня безопасности управляемого устройства.

Перечисления
POSTURE_UNSPECIFIED Не указано. Для этого значения позы нет подробностей о позе.
SECURE Это устройство безопасно.
AT_RISK Это устройство может быть более уязвимо для злоумышленников, чем рекомендуется для использования с корпоративными данными.
POTENTIALLY_COMPROMISED Это устройство может быть взломано, и корпоративные данные могут стать доступны неавторизованным лицам.

ОсанкаДеталь

Дополнительные сведения о степени безопасности устройства.

JSON-представление 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Поля
securityRisk

enum ( SecurityRisk )

Конкретный риск безопасности, который отрицательно влияет на уровень безопасности устройства.

advice[]

object ( UserFacingMessage )

Соответствующие рекомендации администратору по снижению этого риска безопасности и повышению уровня безопасности устройства.

БезопасностьРиск

Риск, из-за которого устройство находится не в самом безопасном состоянии.

Перечисления
SECURITY_RISK_UNSPECIFIED Не указано.
UNKNOWN_OS API Play Integrity обнаруживает, что устройство работает под управлением неизвестной ОС (проверка basicIntegrity проходит успешно, но ctsProfileMatch завершается неудачей).
COMPROMISED_OS API Play Integrity обнаруживает, что на устройстве установлена ​​скомпрометированная ОС (проверка basicIntegrity не пройдена).
HARDWARE_BACKED_EVALUATION_FAILED API целостности Play определяет, что устройство не имеет надежной гарантии целостности системы, если метка MEETS_STRONG_INTEGRITY не отображается в поле целостности устройства .

CommonCriteriaModeInfo

Информация о режиме общих критериев — стандартах безопасности, определенных в Общих критериях оценки безопасности информационных технологий (CC).

Эта информация доступна только в том случае, если в политике устройства statusReportingSettings.commonCriteriaModeEnabled имеет true .

JSON-представление 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
Поля
commonCriteriaModeStatus

enum ( CommonCriteriaModeStatus )

Включен ли режим общих критериев.

policySignatureVerificationStatus

enum ( PolicySignatureVerificationStatus )

Только вывод. Статус проверки подписи политики.

CommonCriteriaModeStatus

Включен ли режим общих критериев.

Перечисления
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Статус неизвестен.
COMMON_CRITERIA_MODE_DISABLED Режим общих критериев в настоящее время отключен.
COMMON_CRITERIA_MODE_ENABLED Режим общих критериев в настоящее время включен.

ПолитикаПодписьПроверкаСтатус

Статус проверки подписи политики.

Перечисления
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Не указано. Статус проверки не был сообщен. Устанавливается только если statusReportingSettings.commonCriteriaModeEnabled имеет значение false.
POLICY_SIGNATURE_VERIFICATION_DISABLED Проверка подписи политики отключена на устройстве, так как commonCriteriaMode имеет значение false.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED Проверка подписи политики прошла успешно.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED Проверка подписи политики не поддерживается, например, потому что устройство было зарегистрировано в версии CloudDPC, которая не поддерживает проверку подписи политики.
POLICY_SIGNATURE_VERIFICATION_FAILED Проверка подписи политики не пройдена. Политика не применена.

DpcMigrationInfo

Информация о том, было ли это устройство перенесено из-под управления другого контроллера политики устройств (DPC).

JSON-представление 
{
  "previousDpc": string,
  "additionalData": string
}
Поля
previousDpc

string

Только вывод. Если это устройство было перенесено из другого DPC, это имя его пакета. В противном случае не заполняется.

additionalData

string

Только вывод. Если это устройство было перенесено из другого DPC, здесь заполняется поле additionalData токена миграции.

Методы

delete

 Удаляет устройство.

get

 Получает устройство.

issueCommand

 Выдает команду устройству.

list

 Перечисляет устройства для данного предприятия.

patch

 Обновляет устройство.