Récupérer les commentaires des applications

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

Une application ne peut envoyer les premiers commentaires immédiats qu'une fois toutes les minutes. Les commentaires générés pendant la période d'attente sont mis en file d'attente et envoyés en totalité à la fin de cette période. Par exemple, lorsqu'un commentaire est généré trois fois à [t=0s;10s;15s] avec une période d'attente d'une minute, le premier retour immédiat est envoyé à [t=0s], le deuxième et le troisième retour à [t=60s].

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 de fonctionnement est décrit dans la section Afficher un commentaire pour pour les entreprises.

Activer les rapports sur les appareils

Les applications envoient des états d'application clés pour chaque appareil. Les états sont inclus dans rapports sur les appareils. Pour activer la création de rapports pour un appareil:

  1. Suivez les instructions pour configurer les notifications Pub/Sub. pour les entreprises. À l'étape 5, inclure STATUS_REPORT dans enabledNotificationTypes.
  2. Pour chaque appareil, mettez à jour les règles relatives aux appareils: définissez StatusReportingSettings.applicationReportsEnabled vers true.

Vous pouvez désormais utiliser l'API Pub/Sub pour recevoir des notifications de rapport sur les appareils. Vous pouvez également consulter à tout moment le dernier rapport concernant un appareil en appelant le devices.get().

Afficher les états d'application clés dans les rapports sur les appareils

Les rapports sur les appareils sont disponibles sous la forme de ressources relatives aux appareils. Les états d'application clés sont regroupés par nom de package dans la section Rapport sur les applications, comme illustré dans l'exemple ci-dessous:

{
   "applicationReports":[
      {
         "packageName": "pkg1",
         "versionCode": 101,
         "keyedAppStates":[
            {
               "key": "key1",
               "severity": INFO,
               "message": "message1",
               "data": "data1",
               "createTime": "2018-10-01T15:01:22.027623745Z",
               "lastUpdateTime": "2018-10-02T15:01:23.045123456Z"
            }
         ]
      }
   ]
}

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".
createTime Code temporel indiquant quand l'état de l'application a été créé sur l'appareil.
lastUpdateTime Code temporel indiquant la date et l'heure de la dernière mise à jour de l'état de l'application sur 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 :

  1. Un administrateur informatique utilise votre console EMM pour Définir des configurations gérées pour une application.
  2. Dans le backend, vous utilisez ApplicationPolicy. pour envoyer les configurations à l'application.
  3. 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).
  4. Pour afficher ces états d'application associés, vous devez récupérer un rapport sur les appareils.
  5. À 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 la même clé que l'état d'erreur d'origine et une sévérité mise à jour de INFO. Fournisseurs EMM doivent toujours informer les organisations dès qu'une erreur est corrigée. Pour Par exemple, supprimez l'erreur du tableau de bord des erreurs de votre console ou marquez-la comme résolu.