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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

lastStatusReportTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

lastPolicyComplianceReportTime
(deprecated)

string ( Timestamp format)

Устарело.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

lastPolicySyncTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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 .

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 Предприятие больше не зарегистрировано в управляемом Google Play, или администратор не принял последнюю версию Условий использования управляемого 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 .

Конкретныйнесоответствиеконтекст

Дополнительный контекст 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 )

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

Информация о программном обеспечении

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

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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

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

Перечисления
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
}
Поля
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 и более поздних версий.

Отображать

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

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

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

Дисплайстате

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

Перечисления
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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

ТипСобытияПриложения

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

Перечисления
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.

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

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

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

КейедAppState

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

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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

lastUpdateTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Серьезность

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

Перечисления
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

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

telephonyInfos[]

object ( TelephonyInfo )

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

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

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

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

string

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

carrierName

string

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

iccId

string

Только вывод. ICCID, связанный с этой 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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

byteCount

string ( int64 format)

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

ТипПамятьСобытия

Тип события.

Перечисления
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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

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

additionalData

string

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

Методы

delete

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

get

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

issueCommand

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

list

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

patch

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