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.

Activer les notifications push EMM

Ce guide part du principe que vous disposez déjà d'un ESA créé manuellement et vous montre comment le configurer pour l'utiliser avec les notifications push EMM. Les tâches sont terminées par le propriétaire ESA (vous, en tant que fournisseur de solutions EMM ou votre client) à l'aide de la Console Google APIs:

1. Activez l'accès à l'API Google Cloud Pub/Sub dans la console Google APIs pour une Google Cloud.

2. Accordez des autorisations d'éditeur à l'ESA.

3. Configurez un projet pour recevoir les notifications EMM.

4. Envoyez une notification EMM test.

5. S'abonner au sujet

Ces étapes sont décrites plus en détail dans les sections ci-dessous.

1. Activer l'accès à l'API Cloud Pub/Sub pour un projet

Pour activer l'API Cloud Pub/Sub pour votre projet:

Dans la console APIs, ouvrez la bibliothèque d'API. Sélectionner le projet (ou créez-en un, si nécessaire). La bibliothèque d'API répertorie disponibles, regroupées par famille de produits et par popularité.
Dans la section "API Google Cloud", recherchez l'API Cloud Pub/Sub. (Si ce n'est pas le cas, visible dans la liste, utilisez la recherche pour la trouver.)
Sélectionnez API Cloud Pub/Sub, puis cliquez sur Activer.

Après avoir activé une API, accédez à la page API et Services, cliquez sur Tableau de bord pour afficher la liste de toutes vos API activées Avant le cloud L'API Pub/Sub peut être utilisée pour les messages adressés à votre client, vous devez accorder le rôle autorisations accordées au compte de service de ce client (son ESA).

2. Accorder des autorisations d'éditeur à l'ESA

Dans la console APIs, accordez les autorisations nécessaires:

Dans la section API et Services, cliquez sur Identifiants. Vous devez l'ESA de votre client s'affiche sous "Clés de compte de service".
Cliquez sur Gérer les comptes de service pour ouvrir tous les comptes de service. associées au projet.
Dans la liste, sélectionnez le compte ESA concerné, puis cliquez sur Autorisations :
Dans le champ Ajouter des membres: <ph type="x-smartling-placeholder">
- Saisissez l'adresse e-mail associée à l'ESA.
- Dans le menu déroulant, sélectionnez Éditeur (à côté de ).
Cliquez sur Add (Ajouter) pour enregistrer les autorisations.

3. Configurer un projet pour recevoir les notifications EMM

Avec l'API Cloud Pub/Sub activée et une ESA configurée avec Editor vous pouvez configurer un projet pour recevoir les notifications EMM détaillé dans Configurer les notifications push EMM. En bref, le processus de configuration implique de configurer un point de terminaison de serveur HTTP pour envoyer des notifications aux abonnés.

Les notifications EMM sont envoyées protobufs (tampons de protocole, un format simple pour la sérialisation des données structurées) empaquetés sous la forme des messages de tableau d'octets encodés en byte64 à l'intérieur de paquets JSON. Dans votre code, vous devez pour analyser ce fichier JSON et décoder le contenu du Protocol Buffer. Voici un exemple : d'un tampon de protocole encodé en base64 pour une URL NewPermissionsEvent notification:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

Il décode en:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

Pour décoder les notifications EMM au format protobuf, vous pouvez utiliser le emm_pubsub.proto fichier situé dans le google/play-work sur GitHub. Lorsque de nouveaux types de notifications sont ajouté, ce fichier est étendu avec le nouveau type et l'exemple de code est mis à jour. Ces modifications devraient être rétrocompatibles, mais assurez-vous que votre code peut y faire face recevoir des notifications de types inconnus, en plus répertoriés dans le fichier .proto.

4. Envoyer une notification EMM test

L'envoi d'une notification test vous permet de confirmer que vous avez réussi configurer votre système pour recevoir les notifications EMM de Google Play ; vous permet également de connaître le nom du sujet (le même nom de sujet est utilisé pour présenter toutes les notifications EMM Google Play).

À l'aide de l'API EMM Play, appelez la méthode sendTestPushNotification sur la ressource Enterprises.

L'appel de cette opération entraîne l'envoi d'une notification EMM de test. Si EMM sont correctement configurées, l'API renvoie ce qui suit:

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

À l'aide de l'exemple de code fourni dans la section Exécuter le code de test de l'éditeur (dans la procédure Configurer la configuration push EMM des notifications), abonnez-vous au sujet spécifié. Vous devriez recevoir la notification EMM de test, ainsi que les notifications réelles qui ont été généré depuis le début du processus de configuration.