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

user Name

string

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

management Mode

enum ( ManagementMode )

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

state

enum ( DeviceState )

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

applied State

enum ( DeviceState )

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

policy Compliant

boolean

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

non Compliance Details[]

object ( NonComplianceDetail )

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

enrollment Time

string ( Timestamp format)

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

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

last Status Report Time

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

last Policy Sync Time

string ( Timestamp format)

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

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

policy Name

string

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

applied Policy Name

string

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

applied Policy Version

string ( int64 format)

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

api Level

integer

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

enrollment Token Data

string

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

enrollment Token Name

string

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

disabled Reason

object ( UserFacingMessage )

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

software Info

object ( SoftwareInfo )

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

hardware Info

object ( HardwareInfo )

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

displays[]

object ( Display )

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

application Reports[]

object ( ApplicationReport )

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

previous Device Names[]

string

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

network Info

object ( NetworkInfo )

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

memory Info

object ( MemoryInfo )

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

memory Events[]

object ( MemoryEvent )

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

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

power Management Events[]

object ( PowerManagementEvent )

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

hardware Status Samples[]

object ( HardwareStatus )

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

device Settings

object ( DeviceSettings )

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

user

object ( User )

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

system Properties

map (key: string, value: string)

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

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

security Posture

object ( SecurityPosture )

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

ownership

enum ( Ownership )

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

common Criteria Mode Info

object ( CommonCriteriaModeInfo )

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

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

applied Password Policies[]

object ( PasswordRequirements )

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

  • Применяемые требования в некоторых случаях могут немного отличаться от тех, которые указаны в passwordPolicies .
  • fieldPath устанавливается на основе passwordPolicies .
dpc Migration Info

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

string

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

non Compliance Reason

enum ( NonComplianceReason )

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

package Name

string

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

field Path

string

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

current Value

value ( Value format)

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

installation Failure Reason

enum ( InstallationFailureReason )

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

specific Non Compliance Reason

enum ( SpecificNonComplianceReason )

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

specific Non Compliance Context

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)
  }
}
Поля
onc Wifi Context

object ( OncWifiContext )

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

password Policies Context

object ( PasswordPoliciesContext )

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

OncWifiContext

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

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

string

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

Контекст политики паролей

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

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

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

string

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

android Device Policy Version Code

integer

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

android Device Policy Version Name

string

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

android Build Number

string

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

device Kernel Version

string

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

bootloader Version

string

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

android Build Time

string ( Timestamp format)

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

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

security Patch Level

string

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

primary Language Code

string

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

device Build Signature

string

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

system Update Info

object ( SystemUpdateInfo )

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

SystemUpdateInfo

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

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

enum ( UpdateStatus )

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

update Received Time

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 .

device Baseband Version

string

Базовая версия. Например, MDM9625_104662.22.05.34p .

manufacturer

string

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

serial Number

string

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

model

string

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

battery Shutdown Temperatures[]

number

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

battery Throttling Temperatures[]

number

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

cpu Shutdown Temperatures[]

number

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

cpu Throttling Temperatures[]

number

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

gpu Shutdown Temperatures[]

number

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

gpu Throttling Temperatures[]

number

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

skin Shutdown Temperatures[]

number

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

skin Throttling Temperatures[]

number

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

enterprise Specific Id

string

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

Отображать

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

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

string

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

display Id

integer

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

refresh Rate

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

string

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

version Name

string

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

version Code

integer

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

events[]

object ( ApplicationEvent )

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

display Name

string

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

package Sha256 Hash

string

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

signing Key Cert Fingerprints[]

string

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

installer Package Name

string

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

application Source

enum ( ApplicationSource )

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

state

enum ( ApplicationState )

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

keyed App States[]

object ( KeyedAppState )

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

user Facing Type

enum ( UserFacingType )

Независимо от того, ориентировано ли приложение на пользователя.

ПриложениеEvent

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

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

enum ( ApplicationEventType )

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

create Time

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

create Time

string ( Timestamp format)

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

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

last Update Time

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 .

wifi Mac Address

string

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

networkOperatorName
(deprecated)

string

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

telephony Infos[]

object ( TelephonyInfo )

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

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

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

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

string

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

carrier Name

string

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

icc Id

string

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

Информация о памяти

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

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

string ( int64 format)

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

total Internal Storage

string ( int64 format)

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

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

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

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

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

enum ( MemoryEventType )

Тип события.

create Time

string ( Timestamp format)

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

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

byte Count

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
}
Поля
event Type

enum ( PowerManagementEventType )

Тип события.

create Time

string ( Timestamp format)

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

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

battery Level

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
  ]
}
Поля
create Time

string ( Timestamp format)

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

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

battery Temperatures[]

number

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

cpu Temperatures[]

number

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

gpu Temperatures[]

number

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

skin Temperatures[]

number

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

fan Speeds[]

number

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

cpu Usages[]

number

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

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

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

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

boolean

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

unknown Sources Enabled

boolean

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

development Settings Enabled

boolean

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

adb Enabled

boolean

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

is Encrypted

boolean

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

encryption Status

enum ( EncryptionStatus )

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

verify Apps Enabled

boolean

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

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

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

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

БезопасностьПозиция

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

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

enum ( DevicePosture )

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

posture Details[]

object ( PostureDetail )

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

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

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

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

ПозаДеталь

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

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

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)
}
Поля
common Criteria Mode Status

enum ( CommonCriteriaModeStatus )

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

policy Signature Verification Status

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
}
Поля
previous Dpc

string

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

additional Data

string

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

Методы

delete

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

get

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

issue Command

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

list

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

patch

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