Vous avez besoin d'un serveur de réservation pour permettre au Centre d'actions d'effectuer des rappels afin de créer et de modifier des réservations en votre nom. Avec cette méthode, vous autorisez Actions Center à créer des rendez-vous et des réservations auprès de votre établissement au nom de l'utilisateur.
Pour savoir comment configurer la connexion à vos serveurs de réservation de bac à sable et de production, consultez Configurer les identifiants du serveur de réservation.
Effectuez les tâches suivantes pour préparer le serveur de réservation avant de passer aux mises à jour en temps réel :
- Page BatchAvailabilityLookup chargée
- Emplacement BatchAvailabilityLookup prêt pour les clics
- CreateBooking Ready
- UpdateBooking prêt
- Activez le vérificateur de disponibilité dans la section Fonctionnalités du compte de la configuration Actions Center.
Chaque tâche est marquée comme terminée et devient verte lorsque vous envoyez des informations précises et en temps réel sur l'inventaire aux demandes du serveur de réservation via le flux de réservation du bac à sable. Les étapes du serveur de réservation sont analysées sur une période de 14 jours.
Mettre en œuvre une interface API REST
Mettez en œuvre une interface API basée sur REST. Google pourra alors envoyer des requêtes du serveur de réservation via le protocole HTTPS.
Pour implémenter une interface API, configurez un serveur de réservation de développement ou de bac à sable qui se connecte à l'environnement de bac à sable du Centre d'actions. Ne passez à un environnement de production qu'une fois que le serveur de bac à sable a été entièrement testé.
Toutes les requêtes transmises au serveur de réservation de Google sont liées à l'URL du serveur de réservation définie sur la page Serveur de réservation. Par exemple, si votre URL est définie sur api.example.com/google, toutes les requêtes HealthCheck sont envoyées à api.example.com/google/v3/HealthCheck.
Assurez-vous que le point de terminaison du serveur de réservation approprié est configuré pour les environnements de bac à sable et de production à l'aide du sélecteur d'environnement.
Sécurité et authentification
Toutes les communications avec votre serveur de réservation se font via le protocole HTTPS à l'aide de l'authentification de base. Pour vous aider à configurer votre serveur, nous vous recommandons d'utiliser un outil de validation SSL ou TLS disponible publiquement, tel que SSL Server Test de Qualys.
Toutes les requêtes envoyées par Google à votre serveur de réservation sont authentifiées à l'aide de l'authentification HTTPS standard. Vous pouvez saisir les informations d'authentification de base, le mot de passe et le nom d'utilisateur de votre serveur de réservation sur la page de configuration du serveur de réservation dans Actions Center. Les identifiants doivent être modifiés tous les six mois.
Créer votre serveur de réservation
Le serveur de réservation détermine la façon dont l'intégration communique avec votre système, et effectue ou modifie les réservations. Pour configurer la connexion à vos serveurs de réservation de bac à sable et de production, consultez Configurer les identifiants du serveur de réservation.
Chaque réponse que votre serveur de réservation fournit à une requête de Réserver avec Google doit contenir des informations précises et en temps réel sur l'inventaire. Le tableau suivant présente les méthodes associées à chaque implémentation et inclut des liens vers les formats de protocole de service :
| Méthode | Définition | Réponse | Requête HTTP |
|---|---|---|---|
Chargement de page BatchAvailabilityLookup |
Lorsqu'un utilisateur clique sur Réserver une table pour votre marchand, la requête La charge utile contient de nombreux créneaux basés sur vos derniers importations de flux, que Réserver avec Google considère comme disponibles. |
La réponse doit inclure chaque demande de créneau et la disponibilité actuelle du créneau. Cela empêche l'affichage des créneaux horaires indisponibles. | POST /v3/BatchAvailabilityLookup/ |
BatchAvailabilityLookup clic sur un emplacement |
Lorsqu'un utilisateur se voit proposer des créneaux disponibles pour une réservation et qu'il clique sur l'un d'eux, la requête BatchAvailabilityLookup est appelée pour le clic sur le créneau. |
La réponse doit représenter la disponibilité actuelle et réelle du créneau. S'il est complet avant le clic sur le créneau, renvoyez une réponse indiquant qu'il n'est pas disponible. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
Lorsqu'un utilisateur confirme qu'il souhaite réserver un créneau horaire sélectionné dans la fenêtre modale de réservation, la requête CreateBooking est envoyée. |
La réponse doit indiquer si la réservation a réussi ou échoué. Si la réservation a échoué, vous devez indiquer la raison spécifique de l'échec. Par exemple, l'emplacement a été réservé avant l'appel de la réponse Si une réservation est créée, la réponse inclut un |
POST /v3/CreateBooking/ |
UpdateBooking |
Après avoir effectué une réservation via Réserver avec Google, un utilisateur peut choisir de la modifier. Lorsqu'un utilisateur modifie ou annule sa réservation, une requête UpdateBooking est envoyée. |
Comme pour la réponse CreateBooking, votre réponse à UpdateBooking doit indiquer si la réservation a réussi ou renvoyer la raison spécifique de l'échec. |
POST /v3/UpdateBooking/ |
HealthCheck |
Le Centre d'actions appelle régulièrement votre serveur de réservation pour confirmer que votre infrastructure est active et opérationnelle. | Utilisez le code d'état HTTP pour indiquer l'état de diffusion de votre serveur. Renvoyez un code d'état HTTP 200 si le serveur est actif et fonctionne correctement. Pour indiquer une erreur ou désactiver temporairement votre intégration, renvoyez le code d'état HTTP non-2xx approprié. |
GET /v3/HealthCheck/ |
Parcours de réservation en bac à sable
Pour afficher le parcours de réservation du bac à sable, accédez à la vue Inventaire du Centre d'actions. La colonne RwG – E2E de la vue "Inventaire" affiche un lien En direct (dans le bac à sable) vers le parcours de réservation du bac à sable pour les marchands du bac à sable qui sont associés et qui ont des disponibilités futures.
Voici les actions du parcours de réservation :
- Lorsque vous cliquez sur le lien RwG – E2E, une requête
BatchAvailabilityLookupest déclenchée au chargement de la page et la disponibilité connue du marchand s'affiche. - Lorsque vous cliquez sur un créneau de réservation, la requête
BatchAvailabilityLookupest déclenchée et la fenêtre modale de réservation s'affiche. - Effectuez une réservation à l'aide du module de réservation pour envoyer la demande
CreateBooking. - Une fois que vous avez effectué une réservation dans l'environnement de bac à sable, le compte utilisé pour créer la réservation reçoit un e-mail de confirmation contenant les détails de la réservation.
- Pour déclencher la méthode
UpdateBooking, modifiez ou annulez la réservation depuis l'e-mail.
HealthCheck
Veillez à implémenter la méthode HealthCheck dans le bac à sable et en production. Cette méthode renvoie l'état de votre serveur de réservation. Google peut ainsi vérifier en permanence quel est l'état de diffusion de votre serveur de réservation.
Demande : aucune
Valeur renvoyée : aucune
Utilisez le code d'état HTTP pour indiquer l'état de diffusion de votre serveur.
Si le serveur est actif et fonctionne correctement, renvoyez un code d'état HTTP 200. Pour signaler une erreur, renvoyez l'un des codes d'état HTTP.