Alguns apps podem enviar feedback para EMMs na forma de estados de app com chave. O estado de um app com chave é composto por um identificador exclusivo (chave), uma mensagem correspondente (opcional), dados legíveis por máquina (opcional), status de gravidade e carimbo de data/hora. Para enviá-las, um app precisa se integrar à biblioteca do Enterprise Jetpack.
Como um EMM, você pode usar os dados de estados de apps com chaves para manter os administradores de TI atualizados em relação aos apps instalados nos dispositivos e perfis gerenciados. Um exemplo de como isso pode funcionar é descrito em Exibir feedback para empresas.
Ativar relatórios do dispositivo
Os apps enviam estados de app com chave por dispositivo. Antes que qualquer estado de app vinculado seja aceito em qualquer um dos apps no dispositivo, é necessário ativar os relatórios para um dispositivo. Até que a política seja atualizada no dispositivo, todos os estados de apps codificados serão ignorados e perdidos para sempre. Ative os relatórios de dispositivos antes de concluir o registro do dispositivo, o mais cedo possível no processo de inscrição. Isso garante que você receba feedback do app gerado durante o registro do dispositivo e que nenhum estado de app com chave seja perdido.
- Chame
devices.update()
, definindopolicy.deviceReportPolicy
como"deviceReportEnabled"
.
Recuperar relatórios do dispositivo
Há várias maneiras de recuperar um relatório de dispositivos:
- Para acessar relatórios do dispositivo com outras notificações, chame
enterprises.pullNotificationSet()
. Na resposta, cadadeviceReportUpdateEvent
indica um relatório de dispositivo. - Para recuperar um relatório de dispositivo atualizado com os estados mais recentes do app com chave para um
dispositivo especificado, chame
devices.get()
. - Para forçar um dispositivo a fazer upload dos estados mais recentes do app, chame
devices.forceReportUpload()
. Esse método faz upload de um relatório que contém todas as mudanças nos estados do app no dispositivo desde que o último relatório foi gerado.
Ver estados de apps com chave
Os relatórios de dispositivos fazem parte dos recursos do dispositivo. Os relatórios incluem um objeto appState
para cada app (pacote) instalado no dispositivo ou no perfil de trabalho.
Os estados do app chave (keyedAppState
) para um determinado pacote são listados no
objeto appState
, como no exemplo abaixo:
{
"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"
}
}
}
Cada estado com chave contém o seguinte:
Campo | Descrição |
---|---|
key |
A chave exclusiva que identifica o estado. |
severity |
A gravidade do estado INFO indica uma mensagem informativa. Por exemplo, se uma configuração gerenciada for definida. ERROR indica que a empresa precisa tomar medidas para corrigir um problema. Por exemplo, se uma configuração gerenciada não for definida. |
message |
String opcional que fornece detalhes sobre o estado do app. Recomendamos que os desenvolvedores de apps tratem esse campo como uma mensagem voltada ao usuário. |
data |
Uma string opcional que fornece detalhes legíveis por computador aos EMMs sobre o estado do app. Por exemplo, um valor que um administrador de TI possa consultar no seu console, como "notificar-me se os dados da bateria_warning forem < 10". |
stateTimestampMillis |
O carimbo de data/hora (em milissegundos) que indica quando o estado do app foi atualizado pela última vez no dispositivo. |
lastUpdatedTimestampMillis |
O carimbo de data/hora (em milissegundos) que indica quando o dispositivo fez upload dos últimos estados de app com chave. |
Mostre feedback sobre o app para empresas
Os apps podem enviar feedback por vários motivos. No entanto, o caso de uso mais comum para enviar estados de app com chave é enviar feedback sobre configurações gerenciadas. Exemplo:
- Um administrador de TI usa o console de EMM para definir configurações gerenciadas para um app.
- No back-end, você envia as configurações ao app.
- O app tenta aplicar as configurações. Para cada configuração, o app envia um estado com chave indicando o status. Por exemplo, uma mensagem de confirmação ou notificação de erro.
- Para conferir esses estados de apps com chave, recupere um relatório de dispositivos.
- Usando informações dos estados de apps com chaves, o console de EMM mostra o status das configurações gerenciadas de maneira fácil de usar.
Alertar os administradores de TI sobre erros
Um estado de app com chave com gravidade ERROR
indica que a organização precisa agir
para corrigir um problema. Os EMMs sempre devem alertar as organizações
sobre erros, seja pelo console de EMM ou por outros meios. Por exemplo, o
console de EMM pode exibir um painel de erros vinculado ao feedback de um
determinado dispositivo com erros.
Se um estado de erro for corrigido, o app vai enviar um estado de acompanhamento com a mesma chave
que o estado de erro original e uma gravidade atualizada de INFO
. Os EMMs devem
sempre informar as organizações assim que um erro é corrigido. Por exemplo,
remova o erro do painel de erros do console ou marque-o como resolvido.