Некоторые приложения способны отправлять отзывы EMM в виде состояний приложения с указанием ключей . Состояние приложения с ключом состоит из уникального идентификатора (ключа), соответствующего сообщения (необязательно), машиночитаемых данных (необязательно), статуса серьезности и метки времени. Для их отправки приложению необходимо интегрироваться с библиотекой Enterprise Jetpack .
Как EMM, вы можете использовать данные о ключевых состояниях приложений, чтобы держать ИТ-администраторов в курсе приложений, установленных на управляемых устройствах и профилях. Пример того, как это может работать, описан в разделе «Отображение обратной связи предприятиям» .
Включить отчеты об устройствах
Приложения отправляют состояния приложений с ключами для каждого устройства. Прежде чем какие-либо состояния приложения с ключами будут приняты из любого приложения на устройстве, вам необходимо включить отчеты об устройстве для устройства. Пока политика не будет обновлена на устройстве, любые состояния приложения с ключами игнорируются и теряются навсегда. Включите отчеты об устройствах перед завершением регистрации устройства, как можно раньше в процессе регистрации. Это гарантирует, что вы получите обратную связь от приложения, созданную во время регистрации устройства, и что никакие ключевые состояния приложения не будут потеряны.
- Вызовите
devices.update()
, установив дляpolicy.deviceReportPolicy
значение"deviceReportEnabled"
.
Получение отчетов об устройствах
Получить отчет об устройстве можно несколькими способами:
- Чтобы получить отчеты об устройствах вместе с другими уведомлениями, вызовите
enterprises.pullNotificationSet()
. В ответе каждоеdeviceReportUpdateEvent
обозначает отчет об устройстве. - Чтобы получить отчет об устройстве, обновленный с учетом последних состояний приложения с ключами для указанного устройства, вызовите
devices.get()
. - Чтобы заставить устройство загрузить последние состояния приложения, вызовите
devices.forceReportUpload()
. Этот метод загружает отчет, содержащий все изменения в состояниях приложения на устройстве с момента создания последнего отчета.
Просмотр состояний приложения с ключами
Отчеты об устройствах являются частью ресурсов устройства. Отчеты включают объект appState
для каждого приложения (пакета), установленного на устройстве или в его рабочем профиле. Состояния приложения с ключом ( keyedAppState
) для данного пакета перечислены в объекте appState
, как в примере ниже:
{
"result":{
"kind":"androidenterprise#device",
"report":{
"appState":[
{
"keyedAppState":[
{
"severity":"severityError",
"data":"user",
"message":"Username or password are incorrect",
"key":"account",
"stateTimestampMillis":"1556206406926"
}
],
"packageName":"com.google.android.feedbacktestapp"
}
],
"lastUpdatedTimestampMillis":"1556206407685"
},
"androidId":"32714368a0ad8ad5",
"managementType":"managedProfile",
"policy":{
"deviceReportPolicy":"deviceReportEnabled"
}
}
}
Каждое состояние приложения с ключом содержит следующее:
Поле | Описание |
---|---|
key | Уникальный ключ, идентифицирующий состояние. |
severity | Тяжесть состояния: INFO указывает на информативное сообщение. Например, если управляемая конфигурация установлена успешно. ERROR указывает, что предприятию необходимо принять меры для устранения проблемы. Например, если не удалось установить управляемую конфигурацию. |
message | Необязательная строка, предоставляющая подробную информацию о состоянии приложения. Разработчикам приложений рекомендуется рассматривать это поле как сообщение, обращенное к пользователю. |
data | Необязательная строка, предоставляющая EMM машиночитаемые сведения о состоянии приложения. Например, значение, которое ИТ-администратор может запросить в вашей консоли, например «уведомить меня, если данные Battery_warning < 10». |
stateTimestampMillis | Временная метка (в миллисекундах), указывающая, когда состояние приложения в последний раз обновлялось на устройстве. |
lastUpdatedTimestampMillis | Временная метка (в миллисекундах), показывающая, когда устройство в последний раз загружало состояние приложения с ключом. |
Отображение отзывов о приложении для предприятий
Приложения могут отправлять отзывы по разным причинам. Однако наиболее распространенным вариантом использования для отправки состояний приложения с ключами является предоставление отзывов об управляемых конфигурациях. Например:
- ИТ-администратор использует вашу консоль EMM для настройки управляемых конфигураций приложения.
- В серверной части вы отправляете конфигурации в приложение .
- Приложение пытается применить конфигурации. Для каждой конфигурации приложение отправляет ключевое состояние приложения, указывающее его статус (например, сообщение с подтверждением или уведомление об ошибке).
- Чтобы просмотреть эти ключевые состояния приложения, вы получаете отчет об устройстве .
- Используя информацию о состояниях приложений с ключами, ваша консоль EMM отображает состояние управляемых конфигураций в удобной для пользователя форме.
Уведомляйте ИТ-администраторов об ошибках
Состояние приложения с ключом и серьезностью ERROR
указывает на то, что организации необходимо принять меры для устранения проблемы. EMM всегда должны предупреждать организации об ошибках либо через консоль EMM, либо другими способами. Например, ваша консоль EMM может отображать панель ошибок, содержащую ссылку на отзыв для данного устройства с ошибками.
Если состояние ошибки исправлено, приложение отправляет последующее состояние с тем же ключом, что и исходное состояние ошибки, и обновленным уровнем серьезности INFO
. EMM всегда должны информировать организации, как только ошибка будет исправлена. Например, удалите ошибку с панели ошибок вашей консоли или отметьте ее как решенную.