Remarques préliminaires
Pour que Frisbii Media puisse communiquer avec les services Google, les informations d'authentification de Google doivent être enregistrées dans le backend de Frisbii Media. Cet article décrit la procédure de configuration de ces informations d'authentification dans les services Google.
Articles complémentaires utiles :
Pour une introduction à la configuration, nous expliquons les objets les plus importants dans notre article de glossaire.
Pour une meilleure vue d'ensemble des étapes nécessaires, la checklist de configuration Google peut être utile.
Les accès suivants sont nécessaires :
Compte Google Cloud Platform (GCP) : un compte Google Cloud est nécessaire pour utiliser Google Pub/Sub. Si aucun compte n'existe encore, vous pouvez en créer un.
Compte Google Play Console : une application dans laquelle les achats in-app doivent être mis en œuvre doit exister. Cela peut nécessiter un compte pour la Google Play Console.
Compte Frisbii Media : un compte Frisbii Media actif est nécessaire pour recevoir les données des achats in-app. Les fonctions sont disponibles sur les systèmes de stage et de production de Frisbii Media.
Facturation activée : la facturation doit être activée pour le projet Google Cloud.
Qu'est-ce que Google Pub/Sub ?
Google Pub/Sub permet d'envoyer des informations sur les événements d'achat in-app à d'autres destinataires en dehors des systèmes Google. Par exemple, lorsqu'un client effectue un achat, l'application concernée publie un message dans un sujet. Frisbii Media ou d'autres services abonnés reçoivent ce message et peuvent y réagir, par exemple en mettant à jour le compte utilisateur, en associant un abonnement ou en attribuant des droits d'accès.
Configuration de Pub/Sub dans la Google Cloud Console
Les étapes nécessaires à la configuration des fonctions Pub/Sub dans la Google Cloud Console sont décrites ci-dessous. La documentation officielle de Google est disponible ici.
Créer un projet Google Cloud pour la ou les applications souhaitées
Connectez-vous à la Google Cloud Console
Sur la page d'accueil de Cloud, cliquez sur le menu déroulant des projets dans la barre supérieure
Cliquez sur le bouton « Nouveau projet »
Attribuez un nom et un emplacement dans la structure organisationnelle
Enregistrez le projet avec le bouton « Créer »
Plus d'informations dans la documentation Google sur ce sujet
Créer un sujet dans le projet
Ouvrez la section Pub/Sub dans la Google Cloud Console
Ouvrez l'élément de menu Sujets dans Pub/Sub
Cliquez sur le bouton « Créer un sujet » dans la barre d'en-tête
Nommez le sujet (par exemple « achats-in-app ») dans le champ « ID du sujet »
Décochez la case « Ajouter un abonnement par défaut »
Chiffrement : sélectionnez « Clé de chiffrement gérée par Google »
Enregistrez le sujet avec le bouton « Créer »
Plus d'informations dans la documentation Google sur ce sujet
Créer un abonnement dans un sujet
Ouvrez à nouveau l'élément de menu Abonnements dans la section Pub/Sub
Cliquez sur le bouton « Créer un abonnement » dans la barre d'en-tête
Nommez l'abonnement et sélectionnez comme source le sujet créé précédemment
Sélectionnez le type de distribution : Push
Saisissez l'URL du point de terminaison : https://callbacks.frisbii-media.com/callbacks/v1.0/appStore/{companyId}/googleplaystore
Le CompanyId Frisbii Media est visible dans l'URL du Merchant Backend, dans le client souhaité : Où trouver le CompanyID ?Définissez la date d'expiration de l'abonnement sur : jamais
Laissez toutes les autres options sur leur valeur par défaut
Plus d'informations dans la documentation Google sur ce sujet
Associer le compte de service Google au sujet
Pour garantir la circulation des informations entre Google Play et Google Pub/Sub, un compte de service Google Play doit être attribué au sujet créé.
Ouvrez le sujet créé à l'étape précédente
Sélectionnez l'onglet « Autorisations » (1) dans la zone de droite et ouvrez l'option « Ajouter un compte principal » (2)
Accordez ensuite au compte de service Google Play « google-play-developer-notifications@system.gserviceaccount.com » l'accès au sujet sélectionné, et attribuez-lui le rôle « Éditeur Pub/Sub » (Pub/Sub Publisher) (2).
Cliquez sur le bouton « Enregistrer » pour finaliser l'association.
Plus d'informations dans la documentation Google sur ce sujet
Activation de l'API Google Play
Une fois le projet Google Cloud configuré avec un sujet et un abonnement, la Google Play Developer API doit être activée pour ce projet. L'API est nécessaire pour permettre la communication entre Google Play et les services Google Cloud.
Pour activer la Google Play Developer API :
Ouvrez la page de la Google Play Developer API dans la Google Cloud Console.
Cliquez sur le bouton « Activer ».