Étape 2: Implémenter les flux

Implémentez votre flux en vous appuyant sur notre documentation de référence. L'environnement de bac à sable vous permet d'importer et de tester votre flux à tout moment.

Créez des flux :

1. Générez vos flux. Vous transmettez la plupart de vos données d'inventaire à Google via des flux. Pour commencer, créez votre flux JSON d'événements et un fichier de descripteur JSON.

   • Event feed:décrit vos événements.
   • Descriptor file:fournit des métadonnées sur votre flux, telles que le code temporel, le type de flux et la liste des fichiers à transmettre dans l'ensemble.

2. Exportez vos flux. Le format des flux est décrit à l'aide de la syntaxe du Protocol Buffer 3. Toutefois, vous pouvez consulter les exemples pour voir le format JSON. Nous vous recommandons d'importer les flux au format JSON.

3. Importez les flux sur votre serveur SFTP. Pour importer vos flux, utilisez les informations sur le serveur SFTP que Google vous a fournies, ainsi que la clé privée que vous avez créée lors de la configuration. Le serveur SFTP de Google est disponible à l'adresse sftp://partnerupload.google.com sur le port 19321.

   Importez vos fichiers avec des noms uniques (par exemple, incluez un code temporel dans le nom). L'utilisation de noms uniques vous permettra de résoudre plus facilement tout problème éventuel et d'envoyer des requêtes pour connaître l'état de vos flux.

   Pour déterminer la taille de vos flux et la fréquence à laquelle les publier, tenez compte des consignes suivantes:

   • Taille des fichiers et des segments de flux :
     • Assurez-vous que la taille du fichier de flux est inférieure à 200 Mo (après compression). Les compresser à l'aide de gzip
     • Si votre fichier peut atteindre plus de 200 Mo (après compression), divisez-le en plusieurs segments en suivant le tutoriel sur le segmentation des fichiers de flux . Toutefois, cette intégration seule est peu susceptible d'atteindre la limite de 200 Mo.
   • Fréquence des mises à jour complètes :
     • Un flux d'événements complet est fourni au moins une fois par jour.
   Remarque:Google traite les fichiers de flux dès qu'ils sont importés sur le serveur SFTP. Si le flux est segmenté en plusieurs fichiers, le processus commence après l'importation du dernier fichier. Si votre flux contient des erreurs, un e-mail contenant les codes d'erreur enregistrés dans le flux vous est envoyé.

Google évalue les flux

Une fois vos flux importés, Google les traite et les évalue pour en vérifier la qualité et s'assurer qu'ils comportent tous les éléments requis. Nous prenons en compte plusieurs facteurs:

• Le flux respecte les spécifications.
• Le flux inclut tous les champs obligatoires.
• Les données sur les établissements correspondent à des adresses sur Google Maps.

Remarque:Avant d'envoyer vos flux, pré-évaluez ces facteurs (à l'exception du dernier). Vous vous assurerez ainsi de la fluidité de votre intégration.