Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play. En savoir plus

Cette page a été traduite par l'API Cloud Translation.

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

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éfinissant policy.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, chaque deviceReportUpdateEvent 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.