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 .

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 .

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 в третьем приложении, путь будет выглядеть так: 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. Дополнительные сведения (включая информацию о том, как включить использование этого параметра политики) доступны в политике «Разрешенное использование» . Для 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.

PasswordPoliciesContext

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

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

Серийный номер устройства. Однако для личных устройств под управлением Android 12 и выше этот номер совпадает с enterpriseSpecificId .

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 Дисплей находится в состоянии ожидания с низким энергопотреблением.

ApplicationReport

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

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 )

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

ApplicationEvent

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

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 Приложение было откреплено.

ApplicationSource

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

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

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 Приложение ориентировано на пользователя.

NetworkInfo

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

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-картой на устройстве. Поддерживается только на полностью управляемых устройствах, начиная с API Android уровня 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 и выше. Для физических SIM-карт и устройств с API уровня ниже 35 всегда указано ACTIVATION_STATE_UNSPECIFIED .

configMode

enum ( ConfigMode )

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

ActivationState

Состояние активации 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

string ( int64 format)

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

totalInternalStorage

string ( int64 format)

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

MemoryEvent

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

Чтобы различать новые и старые события, мы рекомендуем использовать поле 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 Шифрование активно, а ключ шифрования привязан к профилю пользователя.

SecurityPosture

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

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 )

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

SecurityRisk

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

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

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