Serveur de réservation prêt

Vous avez besoin d'un serveur de réservation pour permettre à Actions Center d'effectuer des rappels afin de créer et de modifier des réservations en votre nom. Actions Center peut ainsi 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.

Avant de passer aux mises à jour en temps réel, effectuez les tâches suivantes pour préparer le serveur de réservation :

Chaque tâche est marquée comme terminée et devient verte lorsque vous envoyez des informations d'inventaire précises et en temps réel aux requêtes du serveur de réservation via le flux de réservation du bac à sable. Les jalons du serveur de réservation sont analysés 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 mettre en œuvre une interface API, configurez un serveur de réservation de développement ou de bac à sable qui se connecte à l'environnement de bac à sable Actions Center. 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 "Booking Server" (Serveur de réservation). Par exemple, si votre URL est définie sur api.example.com/google, toutes les HealthCheck requêtes 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 le test de serveur SSL de Qualys.

Toutes les requêtes envoyées par Google à votre serveur de réservation sont authentifiées à l'aide de l'authentification HTTPS de base. 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 d'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 comment l'intégration communique avec votre système, et effectue ou modifie des 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 de votre serveur de réservation à une requête de Réserver avec Google doit contenir des informations d'inventaire précises et en temps réel. Le tableau suivant présente les méthodes associées à chaque mise en œuvre et inclut des liens vers les définitions du service au format proto :

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 BatchAvailabilityLookup requête est appelée lors du chargement de page.

La charge utile contient de nombreux créneaux basés sur vos dernières importations de flux, que Réserver avec Google considère comme disponibles.

 La réponse doit inclure chaque requête de créneau et la disponibilité actuelle du créneau. Cela empêche l'affichage de créneaux indisponibles. POST /v3/BatchAvailabilityLookup/
Clic sur un créneau BatchAvailabilityLookup Lorsqu'un utilisateur voit des créneaux disponibles pour la réservation et clique sur un créneau, 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 réservé avant le clic sur le créneau, renvoyez la 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 CreateBooking requête 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, le créneau a été réservé avant l'appel de la CreateBooking réponse.

Si une réservation est créée, la réponse inclut un booking_id unique permettant de faire référence à la réservation dans les requêtes ou mises à jour ultérieures.

 POST /v3/CreateBooking/
UpdateBooking Une fois une réservation effectuée via Réserver avec Google, un utilisateur peut choisir de la modifier. Lorsque l'utilisateur modifie ou annule sa réservation, une requête UpdateBooking est envoyée. Comme la CreateBooking réponse, votre réponse à UpdateBooking doit indiquer si la réservation a réussi ou renvoyer la raison spécifique d'un échec. POST /v3/UpdateBooking/
HealthCheck Actions Center appelle régulièrement votre serveur de réservation pour confirmer que votre infrastructure est active et en cours d'exécution.

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 signaler une erreur ou désactiver temporairement votre intégration, renvoyez le code d'état HTTP approprié (autre que 2xx) .

 GET /v3/HealthCheck/

Critères des jalons

Pour atteindre le jalon "Booking Server Ready" (Serveur de réservation prêt), votre intégration doit répondre aux critères suivants dans les environnements de bac à sable et de production :

Méthode Nombre de requêtes requis (bac à sable) Nombre de requêtes requis (production) Taux de réussite requis
Chargement de page BatchAvailabilityLookup 20 20 90%
Clic sur un créneau BatchAvailabilityLookup 20 20 90%
CreateBooking 10 3 90 %
UpdateBooking 10 3 90%

Flux de réservation du bac à sable

Pour afficher le flux de réservation du bac à sable, accédez à la vue d'inventaire Actions Center Inventory. La colonne RwG - E2E de la vue d'inventaire affiche un lien Live (in Sandbox) (En direct (dans le bac à sable)) vers le flux de réservation du bac à sable pour les marchands du bac à sable qui sont mis en correspondance et qui ont une disponibilité future.

Voici les actions du flux de réservation :

  • Lorsque vous cliquez sur le lien RwG - E2E, une requête BatchAvailabilityLookup est déclenchée lors du chargement de la page et la disponibilité connue du marchand s'affiche.

  • Lorsque vous cliquez sur une heure de réservation, la requête BatchAvailabilityLookup est déclenchée lors du clic sur le créneau et la fenêtre modale de réservation s'affiche.

  • Effectuez une réservation à l'aide de la fenêtre modale de réservation pour envoyer la requête 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 à partir de l'e-mail.

HealthCheck

Veillez à mettre en œuvre la méthode HealthCheck dans les environnements de bac à sable et de 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.

Requête : 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.