Configurer les notifications EMM

Google Play génère des notifications, appelées notifications EMM, en réponse à divers événements qui affectent une entreprise. Par exemple, lorsqu'une application est approuvée, le système envoie une notification ProductApprovalEvent.

Les notifications EMM sont associées à un compte de service d'entreprise (ESA) spécifique. En tant qu'EMM, vous pouvez configurer votre console pour qu'elle affiche des alertes ou des messages aux administrateurs informatiques de l'entreprise en fonction des notifications que vous recevez.

Les notifications EMM sont envoyées à l'aide de Google Cloud Pub/Sub. Pour en savoir plus sur la configuration des notifications Pub/Sub, consultez la présentation des abonnés et le guide pour les abonnés – Mode pull.

Pour vérifier que vous avez correctement configuré votre système pour recevoir des notifications EMM de Google Play et pour récupérer le nom du sujet Cloud Pub/Sub auquel vous devez associer votre abonnement, appelez Enterprises.sendTestPushNotification.

L'envoi d'une notification de test valide l'intégration de votre EMM au service Google Cloud Pub/Sub pour l'entreprise. Si les notifications EMM sont correctement configurées, l'API renvoie ce qui suit:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

Notifications pull

Google Cloud Pub/Sub est compatible avec deux mécanismes de notification différents: pull et push. Toutefois, seules les notifications pull sont recommandées. L'approche pull ne nécessite aucune configuration de serveur externe et fonctionne à la fois avec des ESA créés de manière programmatique et manuelle. Autre avantage des notifications pull : elles ne nécessitent que peu ou pas de configuration ni de maintenance supplémentaires de la part de vos clients. Utilisez Enterprises.pullNotificationSet et Enterprises.acknowledgeNotificationSet pour recevoir et confirmer les notifications EMM via des connexions sortantes de longue durée.

Lorsque vous appelez Enterprises.pullNotificationSet, nous vous recommandons de laisser requestMode sur sa valeur par défaut (waitForNotifications). La requête attend alors qu'une ou plusieurs notifications soient présentes avant de renvoyer une réponse. Si aucune notification n'est présente au bout d'un certain temps, la requête renvoie une liste de notifications vide, après quoi vous pouvez réessayer.

Une fois que vous avez reçu les notifications, appelez Enterprises.acknowledgeNotificationSet pour vous assurer que les mêmes notifications ne sont pas renvoyées la prochaine fois que vous appelez Enterprises.pullNotificationSet.

Vous pouvez également définir requestMode sur returnImmediately lorsque vous appelez Enterprises.pullNotificationSet. Vous recevrez immédiatement une réponse à la requête, contenant les notifications en attente ou une liste vide si aucune notification n'est présente. Cette option requestMode peut être utile lorsque vous testez initialement l'implémentation de vos notifications.

Exemples de notifications EMM

Voici quelques exemples d'événements et des types de notifications qu'ils génèrent:

Remarque:Les types de notifications suivants sont obsolètes : ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent et NewDeviceEvent. Pour AppUpdateEvent, vous devez utiliser le mode de mise à jour prioritaire , conformément à nos recommandations.