Cette section fournit plus de détails sur les trois principaux éléments d'une intégration avec Actions Center. Vous utiliserez chacun de ces éléments lors des étapes décrites dans le guide de bout en bout.
Flux
Les flux sont des fichiers au format JSON ou pb3 qui permettent de transmettre vos données d'inventaire au Centre d'actions. Vous pouvez ainsi envoyer toutes vos données en même temps pour mettre à jour les marchands, les services et les créneaux de disponibilité à l'aide d'une importation SFTP.
API Maps Booking
L'API Maps Booking vous permet de mettre à jour des objets dans le système Actions Center entre chaque envoi de flux. Elle vous permet également d'annuler des réservations effectuées via l'intégration de bout en bout de Réserver avec Google.
Les mises à jour en temps réel sont implémentées à l'aide d'appels REST.
Serveur de réservation
Pour que l'intégration de bout en bout du Centre d'actions puisse créer des réservations en votre nom, vous devez configurer un serveur de réservation.
API REST
La version v3 est la dernière version de l'API. Elle est compatible avec une interface REST. Toutes les nouvelles intégrations doivent utiliser l'API v3.
Cette section spécifie les fichiers de flux utilisés pour transmettre vos données d'inventaire au Centre d'actions. Le contenu de vos flux définit les services que vous fournissez, les services disponibles et à quel moment.
Consultez l'accordéon Références et exemples pour savoir comment partager ces flux avec nous.
La structure des flux d'inventaire est définie par l'API Google Maps Booking.
Le flux suivant est obligatoire pour toute intégration:
- Flux marchands:ce flux contient les données décrivant vos marchands.
De plus, les deux flux suivants sont obligatoires pour l'intégration de bout en bout.
- Flux services:décrit les services fournis par vos marchands.
- Flux de disponibilité:liste les créneaux de disponibilité des services fournis par vos marchands.
Certains champs de ces flux sont obligatoires et d'autres facultatifs. Tout champ marqué comme facultatif peut être omis du flux s'il est vide.
Le format des flux est décrit à l'aide de la syntaxe du Protocol Buffer 3. Vous avez la possibilité d'importer le fichier de flux sous forme de sérialisation binaire des données du tampon de protocole au format pb3 ou au format JSON dérivé. Nous vous recommandons d'importer les flux au format JSON.
Nous vous recommandons d'utiliser gzip pour compresser les flux avant l'importation.
Ce guide est spécifique aux tampons de protocole Actions Center. Pour obtenir des informations générales sur l'utilisation des tampons de protocole pour générer un fichier pb3, voici un exemple en Java.