Votre inventaire varie en raison des nouvelles réservations, des annulations et des modifications d'horaires apportées par vos marchands. L'API Real-Time Update (RTU) est un mécanisme permettant d'informer Google de ces modifications, ainsi que de celles apportées aux réservations existantes.
Les unités de test à distance sont obligatoires dans les cas suivants :
- Lorsqu'un utilisateur annule une réservation sur votre système et que le créneau devient disponible.
- Lorsqu'un utilisateur effectue une réservation via le Centre d'actions et que le créneau n'est plus disponible.
- Une réservation effectuée via Actions Center est annulée de votre côté. Par exemple, une réservation peut être annulée directement par le marchand. Vous devez mettre à jour la réservation et la disponibilité, car le créneau d'origine est de nouveau disponible.
Effectuez la tâche de jalon RTU suivante avant de passer à l'examen de la sandbox :
Chaque tâche est marquée comme terminée et devient verte lorsque les 20 dernières requêtes ne comportent aucune erreur pendant 14 jours. Continuez à envoyer des requêtes qui aboutissent pour que l'étape reste verte.
API RTU et flux
Les mises à jour en temps réel de l'API permettent d'informer Google des modifications incrémentielles de la disponibilité et des réservations de l'inventaire, à mesure qu'elles sont enregistrées en temps réel. En plus des RTU, envoyez des flux de disponibilité complets tous les jours. Vous vous assurez ainsi que Google dispose des informations de disponibilité les plus précises et les plus récentes, telles qu'elles figurent dans votre système. Les flux complets correspondent à un instantané de l'état actuel de la disponibilité de l'inventaire dans votre système.
Pour en savoir plus, consultez les ressources suivantes :
Accéder à l'API
Votre projet Google Cloud vous permet d'accéder à l'API Maps Booking du Centre d'actions, qui vous permet de transmettre des mises à jour en temps réel. Vous devez utiliser un compte Google dans la console Google Developers et fournir le numéro de votre projet Cloud dans la jalon de configuration de votre plan d'intégration. Pour savoir comment activer les API Cloud, consultez Activer les API Cloud.
Utiliser des appels RESTful ou télécharger la bibliothèque cliente
Nous vous recommandons d'envoyer des appels RESTful directement à l'API Maps Booking à l'aide de charges utiles au format JSON. Pour en savoir plus, consultez la documentation sur l'API REST.
Vous pouvez également utiliser des bibliothèques clientes pour vous connecter à l'API.
.| Langue | Télécharger le lien |
|---|---|
| Java | Bibliothèque client Java. Pour en savoir plus, consultez les instructions sur le client Java. |
Des bibliothèques d'assistance supplémentaires qui gèrent les autorisations et d'autres aspects des appels aux API Google sont disponibles au téléchargement. Pour en savoir plus, consultez Exemples de code.
Récupérer le document de découverte
Pour certaines bibliothèques clientes, telles que Ruby, il est nécessaire de récupérer le document de découverte de l'API, qui décrit ses méthodes et ses paramètres.
Pour récupérer le document de découverte, utilisez la commande suivante :
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
Pour en savoir plus sur l'accès à l'API depuis Ruby, consultez Client API Ruby et Bibliothèque d'authentification Ruby.
Effectuer des appels autorisés à l'API
Lorsque vous appelez l'API, consultez la section Préparer un appel d'API délégué pour autoriser votre compte de service avec votre clé privée et le champ d'application OAuth suivant :
https://www.googleapis.com/auth/mapsbooking
Points de terminaison bac à sable et de production
Vous pouvez effectuer des appels vers l'environnement de bac à sable et de production via l'API. Assurez-vous d'activer les deux API dans votre projet Google Cloud. Ces deux API utilisent le même champ d'application, mais leurs points de terminaison sont différents.
Point de terminaison de production : https://mapsbooking.googleapis.com/
Point de terminaison du bac à sable : https://partnerdev-mapsbooking.googleapis.com/
Voici un exemple de modification du point de terminaison en Java :
// This block of code is for OAuth and is the same for prod and sandbox.
GoogleCredential
.fromStream(new FileInputStream(...))
.createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))
// This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
new GoogleMapsBookingAPI.Builder(...)
.setApplicationName(...)
.setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
.build()