Certaines applications peuvent envoyer des commentaires aux EMM sous la forme d'applications clés de sortie. Un état d'application à clé est constitué d'un identifiant unique (clé), message correspondant (facultatif), données lisibles par un ordinateur (facultatif), niveau de gravité l'état et le code temporel. Pour les envoyer, une application doit s'intégrer Bibliothèque Enterprise Jetpack
En tant qu'EMM, vous pouvez utiliser les données des états d'application clés pour que les administrateurs informatiques des applications installées sur les profils et appareils gérés. Exemple pour en savoir plus, consultez la section Afficher des commentaires aux entreprises.
Activer les rapports sur les appareils
Les applications envoient des états d'application clés pour chaque appareil. Avant tout état d'application à clavier dans n'importe quelle application installée sur l'appareil, vous devez l'activer pour un appareil donné. Tant que les règles ne sont pas mises à jour sur l'appareil, sont ignorés et perdus à jamais. Activer les rapports sur les appareils avant finaliser l'enregistrement de l'appareil le plus tôt possible processus. Vous êtes ainsi sûr de recevoir les commentaires sur l'application générés pendant l'appareil l'enregistrement et qu'aucun état d'application saisi n'est perdu.
- Appelez
devices.update()
, en définissantpolicy.deviceReportPolicy
sur"deviceReportEnabled"
.
Récupérer les rapports sur les appareils
Il existe plusieurs façons de récupérer un rapport sur les appareils:
- Pour récupérer les rapports sur les appareils ainsi que d'autres notifications, appelez
enterprises.pullNotificationSet()
Dans la réponse, chaquedeviceReportUpdateEvent
indique un rapport sur l'appareil. - Pour récupérer un rapport sur les appareils mis à jour avec les derniers états d'application associés pour un
l'appareil spécifié, appelez
devices.get()
. - Pour forcer un appareil à importer les derniers états de l'application, appelez
devices.forceReportUpload()
Cette méthode permet d'importer un rapport contenant les modifications apportées aux états de l'application sur la appareil depuis la génération du dernier rapport.
Afficher les états d'application associés
Les rapports sur les appareils font partie des ressources relatives aux appareils. Les rapports incluent un appState
pour chaque application (package) installée sur l'appareil ou dans son profil professionnel.
Les états d'application saisis (keyedAppState
) pour un package donné sont listés dans
appState
, comme dans l'exemple ci-dessous:
{
"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"
}
}
}
Chaque état d'application avec clé contient les éléments suivants:
Champ | Description |
---|---|
key |
Clé unique identifiant l'état. |
severity |
La gravité de l'état: INFO indique un message informatif. (par exemple, si une configuration gérée est correctement définie). ERROR indique que l'entreprise doit prendre des mesures pour corriger un problème. (par exemple, si une configuration gérée n'a pas pu être définie). |
message |
Chaîne facultative fournissant des détails sur l'état de l'application. Nous recommandons aux développeurs d'applications de traiter ce champ comme un message visible par l'utilisateur. |
data |
Chaîne facultative qui fournit aux fournisseurs EMM des détails lisibles par ordinateur sur l'état de l'application. Par exemple, une valeur qu'un administrateur informatique peut interroger dans votre console, telle que "notify me if the battery_warning data < 10". |
stateTimestampMillis |
Code temporel (en millisecondes) indiquant la date et l'heure de la dernière mise à jour de l'état de l'application sur l'appareil. |
lastUpdatedTimestampMillis |
Code temporel (en millisecondes) indiquant l'état de la dernière importation de l'application à clé par l'appareil. |
Diffuser des commentaires sur l'application auprès des entreprises
Les applications peuvent envoyer des commentaires pour diverses raisons. Toutefois, l'utilisation la plus courante l'envoi d'états d'application clés est de fournir des commentaires sur les de configuration. Exemple :
- Un administrateur informatique utilise votre console EMM pour définir des configurations gérées pour une application.
- Dans le backend, vous envoyez les configurations à l'application.
- L'application tente d'appliquer les configurations. Pour chaque configuration, l'application envoie un état d'application à clé indiquant son état (par exemple, une confirmation (message ou notification d'erreur).
- Pour afficher ces états d'application associés, vous devez récupérer un rapport sur les appareils.
- À partir des informations des états d'application à clé, votre console EMM affiche les l'état des configurations gérées de manière conviviale.
Alerter les administrateurs informatiques en cas d'erreurs
Un état d'application associé au niveau de gravité ERROR
indique que l'organisation doit effectuer
l’action afin de corriger
un problème. Les EMM doivent toujours alerter les organisations
aux erreurs, via leur console EMM ou par d'autres moyens. Par exemple, votre
La console EMM peut afficher un tableau de bord des erreurs lié aux commentaires
un appareil donné avec des erreurs.
Si un état d'erreur est corrigé, l'application envoie un état de suivi avec la même clé.
en tant qu'état d'erreur d'origine et la gravité INFO
a été mise à jour. Les EMM doivent
informer toujours les organisations dès qu'une erreur est corrigée. Par exemple :
supprimez l'erreur du tableau de bord des erreurs de votre console ou marquez-la comme résolue.