Pour effectuer des mises à jour en temps réel, vous devez envoyer des requêtes à l'API Maps Booking. L'API Maps Booking nécessite que vous authentifiez vos requêtes via OAuth 2.0 à l'aide d'un compte de service GCP ayant accès à l'API et auquel les RPS nécessaires ont été allouées. Ce guide vous explique les étapes à suivre pour:
- Configurer votre projet Google Cloud
- Créer un compte de service
- Activer l'API Maps Booking dans votre projet GCP
- Déboguer les problèmes courants
Pour en savoir plus sur l'envoi de requêtes à l'API, consultez la section Mises à jour de l'API en temps réel du guide de bout en bout sur les réservations.
Configurer votre projet Google Cloud avec le Centre d'actions
- Connectez-vous à votre compte Google Cloud Platform.
- Vous pouvez créer un projet ou utiliser un projet existant à cette fin.
- Veuillez noter le numéro du projet cloud, car vous en aurez besoin aux prochaines étapes. Le numéro de votre projet Cloud figure également sur la page d'accueil de Google Cloud Platform. Le numéro de projet Cloud est toujours numérique uniquement.
- Veuillez noter le numéro du projet cloud, car vous en aurez besoin aux prochaines étapes. Le numéro de votre projet Cloud figure également sur la page d'accueil de Google Cloud Platform. Le numéro de projet Cloud est toujours numérique uniquement.
- Connectez-vous au portail des partenaires.
- Effectuez l'étape 1 de la page "Tâches d'intégration" du portail des partenaires en indiquant le numéro de projet cloud et l'adresse e-mail du projet cloud (l'adresse e-mail utilisée pour administrer le projet cloud).
Créer un compte de service et des identifiants OAuth
- Reconnectez-vous à votre compte Google Cloud Platform.
- Accédez à IAM et administration > Comptes de service.
- Recherchez l'ID de votre projet cloud existant ou nouvellement créé.
- Créez un compte de service.
- Saisissez les informations du compte de service.
- Attribuez au nouveau compte de service le rôle le plus adapté aux besoins de votre application. Le choix du rôle pour le compte de service n'a aucune incidence sur les appels pouvant être effectués auprès de l'API Google Maps Booking. En effet, l'attribution d'un quota suffisant pour les utiliser est déterminée par l'association de votre numéro de projet dans la configuration du Centre d'actions. Si vous ne savez pas quel rôle choisir, il vous suffit de sélectionner Projet > Lecteur.
- Après avoir cliqué sur "Continuer" à l'étape (6), vous aurez la possibilité de créer des clés JSON.
- Enregistrez les identifiants JSON. Veillez à les conserver en lieu sûr, car vous ne pourrez pas les récupérer par la suite.
- Reconnectez-vous au portail des partenaires et effectuez les tâches restantes sur la page Tâches d'intégration du portail des partenaires.
Activer l'API MapsBooking
- Connectez-vous à votre compte Google Cloud Platform.
- Accédez à API et services > Tableau de bord.
- Cliquez sur Activer les API et les services et recherchez
Google Maps Booking API.
- Activez les API suivantes :
- API Google Maps Booking
- API Google Maps Booking (en développement)
Erreurs courantes
Plusieurs raisons peuvent expliquer les problèmes d'autorisation lorsque vous effectuez des demandes de mise à jour en temps réel. Si vous avez besoin d'instructions générales sur l'envoi de requêtes de mises à jour en temps réel, consultez la section Mises à jour de l'API en temps réel du guide de bout en bout sur les réservations. Vous trouverez des exemples de clients dans plusieurs langages dans la section Exemples de code.
Si vous rencontrez des erreurs 403, vérifiez que vous respectez toutes les exigences suivantes:
- Utilisez une bibliothèque cliente Google.
- Créez des identifiants OAuth à l'aide de l'authentification de compte de service.
- Accordez l'autorisation en fonction du champ d'application approprié.
- Appelez le point de terminaison approprié (listé ci-dessous).
Assurez-vous d'appeler le bon point de terminaison :
- Bac à sable:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - Production:
https://mapsbooking.googleapis.com/v1alpha/...
Assurez-vous d'autoriser correctement vos demandes d'identifiants OAuth :
- Vous autorisez l'accès pour le champ d'application "https://www.googleapis.com/auth/mapsbooking".
- Vous utilisez la clé de compte de service créée dans la section Créer un compte de service et des identifiants OAuth.
Le problème persiste ?
Si les erreurs continuent de s'afficher après avoir suivi ces étapes, contactez votre contact Actions Center en lui fournissant les informations suivantes:
- Numéro du projet Cloud et ID du projet avec une capture d'écran
- ID du compte de service
- Adresse e-mail utilisée pour créer le compte de service
- Les détails du point de terminaison ont tenté d'envoyer des requêtes à
- Heure des tentatives de requête
- Requête complète et messages d'erreur reçus lors de l'exécution de requêtes.