Cette section fournit plus de détails sur les trois principaux éléments constituant une intégration avec Actions Center. Vous utiliserez chacun de ces éléments dans les étapes décrites dans le Guide d'intégration de bout en bout.
Flux
Les flux sont des fichiers au format JSON ou pb3 utilisés pour transmettre vos données d'inventaire à Actions Center. Vous pouvez ainsi mettre à jour les marchands, les services et les créneaux de disponibilité en envoyant toutes vos données à la fois, via une importation SFTP.
API Maps Booking
L'API Maps Booking vous permet de mettre à jour des objets dans le système Actions Center entre vos envois de flux afin de maintenir les informations à jour. Vous pouvez également utiliser l'API pour annuler les 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 version la plus récente de l'API. Elle est compatible avec une interface basée REST. Toute nouvelle intégration doit 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 les périodes auxquelles ils sont disponibles.
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:contient les données décrivant vos marchands.
En outre, les deux flux suivants sont obligatoires pour une intégration de bout en bout.
- Flux services:décrit les services fournis par vos marchands.
- Flux 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 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 en tant que sérialisation binaire des données du Protocol Buffer, 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 de les importer.
Ce guide concerne spécifiquement les Protocol Buffers du Centre d'actions. Pour en savoir plus sur l'utilisation des Protocol Buffers pour générer un fichier pb3, voici un exemple en Java.