- Ресурс: Устройство
- Состояние устройства
- Детали несоответствия
- InstallationFailureReason
- Конкретная причина несоответствия
- Конкретный контекст несоответствия
- OncWifiContext
- PasswordPoliciesContext
- DefaultApplicationContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- EuiccChipInfo
- Отображать
- DisplayState
- Отчет о приложении
- Событие приложения
- ApplicationEventType
- ApplicationSource
- Состояние приложения
- KeyedAppState
- Степень тяжести
- UserFacingType
- NetworkInfo
- TelephonyInfo
- Состояние активации
- ConfigMode
- MemoryInfo
- Событие памяти
- MemoryEventType
- Событие управления питанием
- PowerManagementEventType
- Состояние оборудования
- Настройки устройства
- Статус шифрования
- Позиция безопасности
- Положение устройства
- PostureDetail
- Риск безопасности
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- Статус проверки подписи
- DpcMigrationInfo
- DefaultApplicationInfo
- DefaultApplicationSettingAttempt
- ПопыткаРезультат
- Методы
Ресурс: Устройство
Устройство, принадлежащее предприятию. Если не указано иное, все поля доступны только для чтения и не могут быть изменены с помощью enterprises.devices.patch .
| JSON-представление |
|---|
{ "name": string, "userName": string, "managementMode": enum ( |
| Поля | |
|---|---|
name | Название устройства в формате |
userName | Имя ресурса пользователя, которому принадлежит это устройство, в формате |
managementMode | Тип режима управления, который используется политикой Android Device Policy на устройстве. Это влияет на то, какие параметры политики поддерживаются. |
state | Состояние, которое необходимо применить к устройству. Это поле можно изменить с помощью запроса на исправление. Обратите внимание, что при вызове |
appliedState | Текущее состояние, к которому относится данное устройство. |
policyCompliant | Соответствует ли устройство установленным правилам. |
nonComplianceDetails[] | Подробная информация о настройках политики, которым устройство не соответствует. |
enrollmentTime | Время регистрации устройства. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
lastStatusReportTime | В последний раз устройство отправляло отчет о состоянии. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
lastPolicyComplianceReportTime | Устарело. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
lastPolicySyncTime | В последний раз устройство получило свою политику. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
policyName | Название политики, применяемой к устройству, в формате |
appliedPolicyName | Название политики, которая в настоящее время применяется к устройству. |
appliedPolicyVersion | Версия политики, применяемая в данный момент к устройству. |
apiLevel | Уровень API версии платформы Android, работающей на устройстве. |
enrollmentTokenData | Если устройство было зарегистрировано с помощью регистрационного токена с предоставленными дополнительными данными, это поле содержит эти данные. |
enrollmentTokenName | Если устройство было зарегистрировано с помощью регистрационного токена, в этом поле содержится имя токена. |
disabledReason | Если состояние устройства — |
softwareInfo | Подробная информация о программном обеспечении устройства. Эта информация доступна только в том случае, если в политике устройства |
hardwareInfo | Подробная информация об аппаратном обеспечении устройства. |
displays[] | Подробная информация о дисплеях устройства. Эта информация доступна только в том случае, если в политике устройства |
applicationReports[] | Отчеты по приложениям, установленным на устройстве. Эта информация доступна только в том случае, если в политике устройства параметр |
previousDeviceNames[] | Если одно и то же физическое устройство было зарегистрировано несколько раз, в этом поле содержатся имена предыдущих устройств. Серийный номер используется в качестве уникального идентификатора для определения того, было ли это же физическое устройство зарегистрировано ранее. Имена расположены в хронологическом порядке. |
networkInfo | Информация о сети устройства. Эта информация доступна только в том случае, если в политике устройства |
memoryInfo | Информация о памяти: содержит сведения о памяти и хранилище устройства. |
memoryEvents[] | События, связанные с измерениями памяти и хранилища, в хронологическом порядке. Эта информация доступна только в том случае, если в политике устройства События сохраняются в течение определенного периода времени, а старые события удаляются. |
powerManagementEvents[] | События управления питанием на устройстве отображаются в хронологическом порядке. Эта информация доступна только в том случае, если в политике устройства |
hardwareStatusSamples[] | Примеры состояния оборудования в хронологическом порядке. Эта информация доступна только в том случае, если в политике устройства |
deviceSettings | Информация о настройках устройства. Эта информация доступна только в том случае, если в политике устройства параметр |
user | Пользователь, которому принадлежит устройство. |
systemProperties | Карта выбранных системных свойств (имя и значение), относящихся к устройству. Эта информация доступна только в том случае, если в политике устройства Объект, содержащий список пар |
securityPosture | Значение показателя уровня безопасности устройства, отражающее степень его защищенности. |
ownership | Право собственности на управляемое устройство. |
commonCriteriaModeInfo | Информация о режиме общих критериев — стандартах безопасности, определенных в Общих критериях оценки безопасности информационных технологий (CC). Эта информация доступна только в том случае, если в политике устройства |
appliedPasswordPolicies[] | В настоящее время к устройству применяются следующие требования к паролю.
|
dpcMigrationInfo | Только вывод. Информация о том, было ли данное устройство перенесено из-под управления другого контроллера политик устройств (DPC). |
defaultApplicationInfo[] | Только вывод. Информация о приложении по умолчанию для Все типы приложений отображаются на полностью управляемых устройствах. Типы |
Состояние устройства
Состояния, которые могут быть применены к устройству.
| Перечисления | |
|---|---|
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 ( |
| Поля | |
|---|---|
settingName | Название параметра политики. Это имя поля верхнего уровня в |
nonComplianceReason | Причина, по которой устройство не соответствует настройкам. |
packageName | Название пакета, указывающее, какое приложение не соответствует требованиям, если таковое имеется. |
fieldPath | Для настроек с вложенными полями, если какое-либо вложенное поле не соответствует требованиям, указывается полный путь к проблемному полю. Путь форматируется так же, как и поле JSON политики в JavaScript, а именно: 1) Для полей типа object имя поля сопровождается точкой, а затем именем подполя. 2) Для полей типа array имя поля сопровождается индексом массива, заключенным в скобки. Например, чтобы указать на проблему с полем |
currentValue | Если параметр политики не удалось применить, используется текущее значение параметра на устройстве. |
installationFailureReason | Если указано |
specificNonComplianceReason | Причина, специфичная для данной политики, по которой устройство не соответствует настройкам. |
specificNonComplianceContext | Дополнительный контекст для |
InstallationFailureReason
Причины, по которым установка приложения может завершиться неудачей.
| Перечисления | |
|---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED | Это значение недопустимо. |
INSTALLATION_FAILURE_REASON_UNKNOWN | Неизвестная причина препятствует установке приложения. Возможные причины: недостаточно места в памяти устройства, нестабильное сетевое соединение или установка занимает больше времени, чем ожидалось. Установка будет повторена автоматически. |
IN_PROGRESS | Монтаж еще не завершен. |
NOT_FOUND | Приложение не найдено в Play Store. |
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 | Сетевая ошибка на устройстве пользователя помешала успешной установке. Обычно это происходит, когда интернет-соединение устройства ухудшается, недоступно или возникают проблемы с конфигурацией сети. Убедитесь, что устройство имеет доступ к полноценному интернет-соединению в сети, соответствующей |
INSUFFICIENT_STORAGE | На устройстве пользователя недостаточно места для установки приложения. Эту проблему можно решить, освободив место на устройстве. Установка или обновление приложения автоматически возобновится, как только на устройстве появится достаточно места. |
Конкретная причина несоответствия
Более подробная информация о причинах несоответствия устройства настройкам политики. В будущем в перечисление можно будет добавить новые значения.
| Перечисления | |
|---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED | Конкретная причина несоответствия не указана. Поля в не заданы. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED | Пользователю необходимо подтвердить учетные данные, введя код блокировки экрана. Поля в не заданы. установлено значение . |
PASSWORD_POLICIES_PASSWORD_EXPIRED | Срок действия пароля устройства или профиля истек. установлен. установлен в . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT | Пароль устройства не соответствует требованиям к паролю. установлен. установлен в значение . |
ONC_WIFI_INVALID_VALUE | В конфигурации Wi-Fi ONC обнаружено некорректное значение. указывает, какое именно значение поля является некорректным. установлен. установлен в . |
ONC_WIFI_API_LEVEL | Параметр ONC Wi-Fi не поддерживается на уровне API версии Android, работающей на устройстве. указывает, какое значение поля не поддерживается. установлен. установлен в . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG | В корпоративной сети Wi-Fi отсутствует либо корневой центр сертификации, либо доменное имя. установлен в . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK | Пользователю необходимо вручную удалить настроенную сеть Wi-Fi. Это применимо только к рабочим профилям на личных устройствах. установлен в . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY | Псевдоним пары ключей, указанный в поле ClientCertKeyPairAlias в не соответствует существующему ключу, установленному на устройстве. Для установлено значение . |
PERMISSIBLE_USAGE_RESTRICTION | Данная настройка политики является ограниченной и не может быть применена к этому проекту Google Cloud Platform. Более подробная информация (включая инструкции по включению использования этой настройки политики) доступна в политике допустимого использования . установлен в значение . |
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE | Рабочая учетная запись, требуемая параметром политики больше не является частью предприятия. установлен на . |
NEW_ACCOUNT_NOT_IN_ENTERPRISE | Рабочая учетная запись, добавленная пользователем, не является частью предприятия. Для параметра установлено значение . |
DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES | Настройки приложения по умолчанию применяются к областям действия, которые не поддерживаются режимом управления, даже если сам режим управления поддерживается для данного типа приложения (например, политика с типом приложения |
DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE | Настройки приложения по умолчанию не применились для определенной области действия. Установлено значение . установлено на или . |
PRIVATE_DNS_HOST_NOT_SERVING | Указанный хост для частного DNS является допустимым именем хоста, но было обнаружено, что он не является частным DNS-сервером. установлен в . |
Конкретный контекст несоответствия
Дополнительный контекст для . SpecificNonComplianceReason
| JSON-представление |
|---|
{ "oncWifiContext": { object ( |
| Поля | |
|---|---|
oncWifiContext | Дополнительная информация о нарушениях, связанных с конфигурацией Wi-Fi. См. |
passwordPoliciesContext | Дополнительная информация о нарушениях, связанных с политикой паролей. См. |
defaultApplicationContext | Только вывод. Дополнительный контекст для случаев несоответствия, связанных с настройками приложения по умолчанию. См. |
OncWifiContext
Дополнительная информация о нарушениях, связанных с настройкой Wi-Fi.
| JSON-представление |
|---|
{ "wifiGuid": string } |
| Поля | |
|---|---|
wifiGuid | GUID несовместимой конфигурации Wi-Fi. |
PasswordPoliciesContext
Дополнительная информация о нарушениях, связанных с политикой паролей.
| JSON-представление |
|---|
{
"passwordPolicyScope": enum ( |
| Поля | |
|---|---|
passwordPolicyScope | Область применения несоответствующих паролей. |
DefaultApplicationContext
Дополнительная информация о нарушениях, связанных с настройками приложения по умолчанию.
| JSON-представление |
|---|
{
"defaultApplicationScope": enum ( |
| Поля | |
|---|---|
defaultApplicationScope | Только для вывода. Область действия несоответствующих настройкам приложения по умолчанию. |
SoftwareInfo
Информация о программном обеспечении устройства.
| JSON-представление |
|---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
| Поля | |
|---|---|
androidVersion | Строка с указанием версии Android, видимая пользователю. Например, |
androidDevicePolicyVersionCode | Код версии приложения Android Device Policy. |
androidDevicePolicyVersionName | Версия приложения Android Device Policy, отображаемая пользователю. |
androidBuildNumber | Строка идентификатора сборки Android, предназначенная для отображения пользователю. Например, |
deviceKernelVersion | Например, версия ядра: |
bootloaderVersion | Номер версии загрузчика системы, например, |
androidBuildTime | Время сборки. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
securityPatchLevel | Уровень исправлений безопасности, например, |
primaryLanguageCode | Код языка IETF BCP 47 для основной локали устройства. |
deviceBuildSignature | Хэш SHA-256 объекта |
systemUpdateInfo | Информация о возможном предстоящем обновлении системы. |
SystemUpdateInfo
Информация о возможном предстоящем обновлении системы.
| JSON-представление |
|---|
{
"updateStatus": enum ( |
| Поля | |
|---|---|
updateStatus | Статус обновления: существует ли обновление и каков его тип. |
updateReceivedTime | Время, когда обновление стало доступно. Нулевое значение указывает на то, что это поле не задано. Это поле устанавливается только в том случае, если обновление доступно (то есть, Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
UpdateStatus
Статус обновления: существует ли обновление и каков его тип.
| Перечисления | |
|---|---|
UPDATE_STATUS_UNKNOWN | Неизвестно, есть ли ожидающие обновления системы. Это происходит, например, если уровень API устройства ниже 26 или если версия политики устройств Android устарела. |
UP_TO_DATE | На устройстве отсутствуют ожидающие обновления системы. |
UNKNOWN_UPDATE_AVAILABLE | В настоящее время доступно ожидающее обновления системы, но его тип неизвестен. |
SECURITY_UPDATE_AVAILABLE | Доступно ожидающее обновления безопасности. |
OS_UPDATE_AVAILABLE | Доступно ожидающее обновление операционной системы. |
HardwareInfo
Информация об аппаратном обеспечении устройства. Поля, относящиеся к температурным порогам, доступны только в том случае, если в политике устройства 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 ( |
| Поля | |
|---|---|
brand | Марка устройства. Например, |
hardware | Название оборудования. Например, |
deviceBasebandVersion | Версия базовой полосы. Например, |
manufacturer | Производитель. Например, |
serialNumber | Серийный номер устройства. Однако для личных устройств под управлением Android 12 и выше это то же самое, что и |
model | Модель устройства. Например, |
batteryShutdownTemperatures[] | Пороговые значения температуры отключения батареи в градусах Цельсия для каждой батареи в устройстве. |
batteryThrottlingTemperatures[] | Пороговые значения температуры, при которых происходит снижение производительности батареи, в градусах Цельсия для каждой батареи в устройстве. |
cpuShutdownTemperatures[] | Пороговые значения температуры отключения процессора в градусах Цельсия для каждого процессора на устройстве. |
cpuThrottlingTemperatures[] | Пороговые значения температуры, определяющие троттлинг процессора, в градусах Цельсия для каждого процессора на устройстве. |
gpuShutdownTemperatures[] | Пороговые значения температуры отключения графического процессора в градусах Цельсия для каждого графического процессора на устройстве. |
gpuThrottlingTemperatures[] | Пороговые значения температуры, ограничивающие производительность графического процессора (GPU), в градусах Цельсия для каждого графического процессора на устройстве. |
skinShutdownTemperatures[] | Пороговые значения температуры отключения устройства при контакте с кожей в градусах Цельсия. |
skinThrottlingTemperatures[] | Пороговые значения температуры, ограничивающие работу устройства под воздействием внешних факторов, в градусах Цельсия. |
enterpriseSpecificId | Только для вывода. Идентификатор, однозначно идентифицирующий личное устройство в конкретной организации. На одном и том же физическом устройстве, зарегистрированном в одной и той же организации, этот идентификатор сохраняется при изменении настроек и даже при сбросе до заводских настроек. Этот идентификатор доступен на личных устройствах с рабочим профилем на устройствах под управлением Android 12 и выше. |
euiccChipInfo[] | Только вывод. Информация, относящаяся к микросхеме eUICC. |
EuiccChipInfo
Информация, относящаяся к микросхеме eUICC.
| JSON-представление |
|---|
{ "eid": string } |
| Поля | |
|---|---|
eid | Только для вывода. Встроенный идентификационный документ (EID), который идентифицирует каждый чип eUICC на устройстве. Эта информация доступна на устройствах, принадлежащих компании и работающих под управлением Android 13 и выше. |
Отображать
Информация, отображаемая на экране устройства.
| JSON-представление |
|---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
| Поля | |
|---|---|
name | Название дисплея. |
displayId | Уникальный идентификатор дисплея. |
refreshRate | Частота обновления дисплея в кадрах в секунду. |
state | Состояние дисплея. |
width | Ширина дисплея в пикселях. |
height | Отображение высоты в пикселях. |
density | Плотность отображения выражается в точках на дюйм. |
DisplayState
Состояние дисплея.
| Перечисления | |
|---|---|
DISPLAY_STATE_UNSPECIFIED | Это значение недопустимо. |
OFF | Дисплей выключен. |
ON | Дисплей включен. |
DOZE | Дисплей находится в режиме ожидания с низким энергопотреблением. |
SUSPENDED | Дисплей находится в спящем режиме с низким энергопотреблением. |
Отчет о приложении
Информация о содержимом установленного приложения.
| JSON-представление |
|---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
| Поля | |
|---|---|
packageName | Название пакета приложения. |
versionName | Версия приложения, отображаемая пользователю. |
versionCode | Код версии приложения, который позволяет определить, является ли одна версия более новой, чем другая. |
events[] | Список событий приложения, произошедших за последние 30 часов. |
displayName | Отображаемое название приложения. |
packageSha256Hash | Хэш SHA-256 APK-файла приложения, который можно использовать для проверки того, что приложение не было изменено. Каждый байт хэша представлен в виде двухзначного шестнадцатеричного числа. |
signingKeyCertFingerprints[] | Хэш SHA-1 каждого элемента |
installerPackageName | Название пакета приложения, которое установило это приложение. |
applicationSource | Источник пакета. |
state | Состояние приложения. |
keyedAppStates[] | Список состояний приложения, отображаемых при вводе текста. |
userFacingType | Приложение ориентировано на пользователя. |
Событие приложения
Мероприятие, связанное с приложением.
| JSON-представление |
|---|
{
"eventType": enum ( |
| Поля | |
|---|---|
eventType | Тип события приложения. |
createTime | Время создания события. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
ApplicationEventType
Тип события, связанного с приложением.
| Перечисления | |
|---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED | Это значение недопустимо. |
INSTALLED | Приложение установлено. |
CHANGED | В приложение были внесены изменения, например, включен или отключен какой-либо компонент. |
DATA_CLEARED | Данные приложения были удалены. |
REMOVED | Приложение было удалено. |
REPLACED | Установлена новая версия приложения, заменившая старую. |
RESTARTED | Приложение было перезапущено. |
PINNED | Приложение было закреплено на переднем плане. |
UNPINNED | Приложение было откреплено. |
ApplicationSource
Источник, предоставивший приложение.
| Перечисления | |
|---|---|
APPLICATION_SOURCE_UNSPECIFIED | Приложение было установлено неофициальным способом из неуказанного источника. |
SYSTEM_APP_FACTORY_VERSION | Это системное приложение из заводского образа устройства. |
SYSTEM_APP_UPDATED_VERSION | Это обновлённое системное приложение. |
INSTALLED_FROM_PLAY_STORE | Приложение было установлено из магазина Google Play. |
CUSTOM | Приложение было установлено с помощью команды AMAPI SDK . См. также: |
Состояние приложения
Текущий статус установки.
| Перечисления | |
|---|---|
APPLICATION_STATE_UNSPECIFIED | Состояние приложения не указано |
REMOVED | Приложение было удалено с устройства. |
INSTALLED | Приложение установлено на устройстве. |
KeyedAppState
Состояние приложения, указанное в ключе.
| JSON-представление |
|---|
{
"key": string,
"severity": enum ( |
| Поля | |
|---|---|
key | Ключ состояния приложения. Служит точкой отсчета для определения того, для чего приложение предоставляет состояние. Например, при предоставлении обратной связи по управляемой конфигурации этот ключ может быть ключом управляемой конфигурации. |
severity | Степень серьезности состояния приложения. |
message | При желании можно добавить произвольную строку сообщения, поясняющую состояние приложения. Если состояние было вызвано определенным значением (например, значением управляемой конфигурации), оно должно быть включено в сообщение. |
data | При желании можно указать машиночитаемое значение для считывания системой EMM. Например, значения, которые администратор может использовать для запросов в консоли EMM (например, «уведомить меня, если значение battery_warning < 10»). |
createTime | Время создания состояния приложения на устройстве. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
lastUpdateTime | Время последнего обновления состояния приложения. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
Степень тяжести
Степень серьезности состояния приложения.
| Перечисления | |
|---|---|
SEVERITY_UNSPECIFIED | Неуказанный уровень тяжести. |
INFO | Уровень серьезности информации. |
ERROR | Уровень серьезности ошибки. Этот параметр следует устанавливать только для действительно серьезных ошибок, для устранения которых руководящему органу необходимо принять меры. |
UserFacingType
Приложение ориентировано на пользователя.
| Перечисления | |
|---|---|
USER_FACING_TYPE_UNSPECIFIED | Тип взаимодействия приложения с пользователем не указан. |
NOT_USER_FACING | Приложение не предназначено для непосредственного взаимодействия с пользователем. |
USER_FACING | Приложение ориентировано на пользователя. |
NetworkInfo
Информация о сети устройства.
| JSON-представление |
|---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
| Поля | |
|---|---|
imei | IMEI-номер GSM-устройства. Например, |
meid | MEID-номер CDMA-устройства. Например, |
wifiMacAddress | MAC-адрес Wi-Fi устройства. Например, |
networkOperatorName | Алфавитное название текущего зарегистрированного оператора. Например, Vodafone. |
telephonyInfos[] | Предоставляет телефонную информацию, связанную с каждой SIM-картой в устройстве. Поддерживается только на полностью управляемых устройствах, начиная с Android 6. |
TelephonyInfo
Телефонная информация, связанная с конкретной SIM-картой на устройстве. Поддерживается для всех SIM-карт на полностью управляемых устройствах под управлением Android 6 и выше. Кроме того, поддерживается для eSIM-карт, добавленных администратором, на всех устройствах под управлением Android 15 и выше.
| JSON-представление |
|---|
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum ( |
| Поля | |
|---|---|
phoneNumber | Номер телефона, связанный с этой SIM-картой. |
carrierName | Название оператора связи, связанного с данной SIM-картой. |
iccId | Только вывод. ICCID, связанный с этой SIM-картой. |
activationState | Только вывод. Состояние активации SIM-карты на устройстве. Применимо только для eSIM. Поддерживается на всех устройствах с Android 15 и выше. Для физических SIM-карт и устройств с Android ниже 15 всегда отображается |
configMode | Только вывод. Режим конфигурации SIM-карты на устройстве. Применимо только для eSIM. Поддерживается на всех устройствах с Android 15 и выше. Для физических SIM-карт и устройств с Android ниже 15 всегда устанавливается |
Состояние активации
Состояние активации SIM-карты на устройстве.
| Перечисления | |
|---|---|
ACTIVATION_STATE_UNSPECIFIED | Состояние активации не указано. |
ACTIVATED | SIM-карта активирована. |
NOT_ACTIVATED | SIM-карта не активирована. |
ConfigMode
Режим настройки SIM-карты на устройстве.
| Перечисления | |
|---|---|
CONFIG_MODE_UNSPECIFIED | Режим конфигурации не указан. |
ADMIN_CONFIGURED | Администратор настроил эту SIM-карту. |
USER_CONFIGURED | Пользователь настроил эту SIM-карту. |
MemoryInfo
Информация о памяти и хранилище устройства.
| JSON-представление |
|---|
{ "totalRam": string, "totalInternalStorage": string } |
| Поля | |
|---|---|
totalRam | Общий объем оперативной памяти на устройстве в байтах. |
totalInternalStorage | Общий объем внутренней памяти устройства в байтах. |
Событие памяти
Событие, связанное с измерениями памяти и хранилища.
Для различения новых и старых событий мы рекомендуем использовать поле . createTime
| JSON-представление |
|---|
{
"eventType": enum ( |
| Поля | |
|---|---|
eventType | Тип события. |
createTime | Время создания события. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
byteCount | Количество свободных байтов на носителе или, для параметра |
MemoryEventType
Тип мероприятия.
| Перечисления | |
|---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED | Не указано. Такого типа мероприятий не существует. |
RAM_MEASURED | Было измерено свободное пространство в оперативной памяти. |
INTERNAL_STORAGE_MEASURED | Было измерено свободное пространство во внутренней памяти. |
EXTERNAL_STORAGE_DETECTED | Обнаружен новый внешний носитель информации. Сообщаемое количество байтов соответствует общей емкости носителя. |
EXTERNAL_STORAGE_REMOVED | Внешний носитель информации был удален. Отображаемое количество байтов равно нулю. |
EXTERNAL_STORAGE_MEASURED | Было измерено свободное пространство во внешнем носителе информации. |
Событие управления питанием
Событие, связанное с управлением энергопотреблением.
| JSON-представление |
|---|
{
"eventType": enum ( |
| Поля | |
|---|---|
eventType | Тип события. |
createTime | Время создания события. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
batteryLevel | Для событий |
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 | Время проведения измерений. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
batteryTemperatures[] | Текущая температура батарей в градусах Цельсия для каждой батареи устройства. |
cpuTemperatures[] | Текущая температура процессора (в градусах Цельсия) для каждого процессора на устройстве. |
gpuTemperatures[] | Текущая температура каждого графического процессора на устройстве (в градусах Цельсия). |
skinTemperatures[] | Текущая температура кожи устройства в градусах Цельсия. |
fanSpeeds[] | Скорость вращения вентиляторов в об/мин для каждого вентилятора на устройстве. Пустой массив означает отсутствие вентиляторов или неподдерживаемую системой скорость вращения вентиляторов. |
cpuUsages[] | Использование ЦП в процентах для каждого доступного ядра устройства. Использование равно 0 для каждого отключенного ядра. Пустой массив означает, что использование ЦП не поддерживается в системе. |
Настройки устройства
Информация о настройках безопасности устройства.
| JSON-представление |
|---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
| Поля | |
|---|---|
isDeviceSecure | Указывается, защищено ли устройство PIN-кодом/паролем. |
unknownSourcesEnabled | Включена ли возможность установки приложений из неизвестных источников. |
developmentSettingsEnabled | Включен ли режим разработчика на устройстве. |
adbEnabled | Проверяет, включен ли ADB на устройстве. |
isEncrypted | Включено ли шифрование хранилища. |
encryptionStatus | Статус шифрования из DevicePolicyManager. |
verifyAppsEnabled | Применяется ли на устройстве проверка Google Play Protect . |
Статус шифрования
Статус шифрования устройства.
| Перечисления | |
|---|---|
ENCRYPTION_STATUS_UNSPECIFIED | Не указано. Ни одно устройство не должно иметь этот тип. |
UNSUPPORTED | Данное устройство не поддерживает шифрование. |
INACTIVE | Устройство поддерживает шифрование, но в данный момент эта функция не активна. |
ACTIVATING | В данный момент шифрование не активировано, но находится в процессе активации. |
ACTIVE | Шифрование активно. |
ACTIVE_DEFAULT_KEY | Шифрование активно, но пользователь не задал ключ шифрования. |
ACTIVE_PER_USER | Шифрование активно, и ключ шифрования привязан к профилю пользователя. |
Позиция безопасности
Уровень безопасности устройства определяется текущим состоянием устройства и применяемыми политиками.
| JSON-представление |
|---|
{ "devicePosture": enum ( |
| Поля | |
|---|---|
devicePosture | Значение показателя уровня безопасности устройства. |
postureDetails[] | Дополнительные сведения о состоянии безопасности устройства. |
Положение устройства
Возможные значения уровня безопасности управляемого устройства.
| Перечисления | |
|---|---|
POSTURE_UNSPECIFIED | Не указано. Для данного значения параметра осанки отсутствуют подробные данные. |
SECURE | Это устройство безопасно. |
AT_RISK | Данное устройство может быть более уязвимо для злоумышленников, чем рекомендуется для использования с корпоративными данными. |
POTENTIALLY_COMPROMISED | Данное устройство может быть скомпрометировано, и корпоративные данные могут стать доступными для неавторизованных лиц. |
PostureDetail
Дополнительные сведения о состоянии безопасности устройства.
| JSON-представление |
|---|
{ "securityRisk": enum ( |
| Поля | |
|---|---|
securityRisk | Конкретный риск безопасности, негативно влияющий на уровень защищенности устройства. |
advice[] | Соответствующие рекомендации для администраторов по снижению этого риска безопасности и повышению уровня защиты устройства. |
Риск безопасности
Риск, из-за которого устройство находится не в самом безопасном состоянии.
| Перечисления | |
|---|---|
SECURITY_RISK_UNSPECIFIED | Не указано. |
UNKNOWN_OS | API Play Integrity определяет, что на устройстве установлена неизвестная операционная система (проверка basicIntegrity проходит успешно, но ctsProfileMatch завершается с ошибкой). |
COMPROMISED_OS | API Play Integrity обнаруживает, что на устройстве установлена скомпрометированная ОС (проверка basicIntegrity завершается неудачей). |
HARDWARE_BACKED_EVALUATION_FAILED | API Play Integrity обнаруживает, что устройство не имеет надежной гарантии целостности системы, если метка MEETS_STRONG_INTEGRITY не отображается в поле целостности устройства . |
CommonCriteriaModeInfo
Информация о режиме общих критериев — стандартах безопасности, определенных в Общих критериях оценки безопасности информационных технологий (CC).
Эта информация доступна только в том случае, если в политике устройства statusReportingSettings.commonCriteriaModeEnabled имеет true .
| JSON-представление |
|---|
{ "commonCriteriaModeStatus": enum ( |
| Поля | |
|---|---|
commonCriteriaModeStatus | Включен ли режим общих критериев. |
policySignatureVerificationStatus | Только вывод. Статус проверки подписи политики. |
CommonCriteriaModeStatus
Включен ли режим общих критериев.
| Перечисления | |
|---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN | Неизвестный статус. |
COMMON_CRITERIA_MODE_DISABLED | Режим общих критериев в данный момент отключен. |
COMMON_CRITERIA_MODE_ENABLED | В данный момент включен режим общих критериев. |
Статус проверки подписи
Статус проверки подписи в рамках политики.
| Перечисления | |
|---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED | Не указано. Статус проверки не был сообщен. Этот параметр устанавливается только в том случае, если имеет значение false. |
POLICY_SIGNATURE_VERIFICATION_DISABLED | Проверка подписи политики отключена на устройстве, поскольку установлен в значение false. |
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED | Проверка подписи политики прошла успешно. |
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED | Проверка подписи политики не поддерживается, например, потому что устройство зарегистрировано с версией CloudDPC, которая не поддерживает проверку подписи политики. |
POLICY_SIGNATURE_VERIFICATION_FAILED | Проверка подписи политики не удалась. Политика не применена. |
DpcMigrationInfo
Information related to whether this device was migrated from being managed by another Device Policy Controller (DPC).
| JSON-представление |
|---|
{ "previousDpc": string, "additionalData": string } |
| Fields | |
|---|---|
previousDpc | Output only. If this device was migrated from another DPC, this is its package name. Not populated otherwise. |
additionalData | Output only. If this device was migrated from another DPC, the |
DefaultApplicationInfo
The default application information for a specific . DefaultApplicationType
| JSON-представление |
|---|
{ "defaultApplicationType": enum ( |
| Fields | |
|---|---|
defaultApplicationType | Output only. The default application type. |
packageName | Output only. The package name of the current default application. |
defaultApplicationSettingAttempts[] | Output only. Details on the default application setting attempts, in the same order as listed in |
DefaultApplicationSettingAttempt
Details on a default application setting attempt.
| JSON-представление |
|---|
{
"packageName": string,
"attemptOutcome": enum ( |
| Fields | |
|---|---|
packageName | Output only. The package name of the attempted application. |
attemptOutcome | Output only. The outcome of setting the app as the default. |
AttemptOutcome
The outcome of setting the app as the default.
| Перечисления | |
|---|---|
ATTEMPT_OUTCOME_UNSPECIFIED | Attempt outcome is unspecified. This is not used. |
SUCCESS | App is successfully set as the default. |
APP_NOT_INSTALLED | Attempt failed as the app is not installed. |
APP_SIGNING_CERT_MISMATCH | Attempt failed as the signing key certificate fingerprint of the app from Play Store or from does not match the one on the device. |
OTHER_FAILURE | Attempt failed due to other reasons. |
Методы | |
|---|---|
| Deletes a device. |
| Gets a device. |
| Issues a command to a device. |
| Lists devices for a given enterprise. |
| Updates a device. |