Étape 2: Flux

Une fois que vous avez créé vos flux, Google les évalue.

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 Merchant (et votre flux Services, le cas échéant) :

   • Un flux marchands : ce flux décrit vos marchands et les liens action_link à leur niveau.
   • Flux de services (facultatif / non recommandé) : Il n'est pas recommandé d'implémenter des flux de services pour les nouvelles intégrations de liens vers des établissements de réservation. Si vous souhaitez conserver votre intégration existante, consultez cette ancienne documentation.

   Champs obligatoires et recommandés

   Flux	Nom du champ	Description	Obligatoire ?
   Marchands	merchant_id	Identifiant unique du marchand	Oui
   Marchands	nom	Nom du marchand	Oui
   Marchands	geo	Adresse et coordonnées géographiques du marchand	Oui
   Marchands	telephone	Numéro de téléphone du marchand	Oui
   Marchands	catégorie	Type de lieu du marchand	Nice to Have (Souhaitable)
   Marchands	action_link	Informations concernant les liens profonds spécifiques aux marchands	Oui
   Marchand	action_link_type	Type d'action de lien. Les partenaires utilisant le lien vers des établissements pour les réservations doivent utiliser ACTION_LINK_TYPE_MAKE_DINING_RESERVATION.
   Marchand	brand_id	Chaîne qui identifie la marque à présenter aux utilisateurs	Facultatif

   Remarque : Ne tenez pas compte des autres champs décrits dans la section de référence.
   Point clé : Vous n'avez qu'à importer le flux de marchand.

   Pour commencer, consultez les exemples de flux.

   • Exemples de flux (secteur de la restauration)

   Pour en savoir plus sur la spécification de liens d'actions dans les flux d'intégration de liens d'établissement pour les réservations, cliquez ici.

   Incluez des métadonnées de flux dans chacun de vos flux pour indiquer à Google comment interpréter le flux.

   Voici un exemple de métadonnées d'un flux :

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }

   Remarque : Pour chaque importation de flux, vous devez définir l'instruction de traitement (processing_instruction) sur PROCESS_AS_COMPLETE. PROCESS_AS_INCREMENTAL est obsolète et ne peut pas être utilisé.
   Remarque : Cette intégration peut également être mise en œuvre en même temps que l'intégration de bout en bout du Centre d'actions ou en complément de celle-ci. Pour ce faire, vous devez également implémenter des flux de disponibilité et les champs obligatoires de l'intégration de bout en bout, comme indiqué dans ce guide.

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 mentionnés ci-dessus pour voir le format JSON. Nous vous recommandons d'importer les flux au format JSON.

   Si vous souhaitez vraiment utiliser le format pb3, consultez Principes de base des Protocol Buffers : Java pour obtenir des informations générales sur l'utilisation des Protocol Buffers pour générer un fichier pb3.

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 horodatage 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 de la segmentation des flux :
     • Assurez-vous que la taille du fichier de flux ne dépasse pas 200 Mo (après compression). Compressez-les à l'aide de gzip.
     • Si la taille de vos fichiers est susceptible de dépasser 200 Mo (après compression), scindez-les en plusieurs segments en suivant le tutoriel Scinder les fichiers de flux . Toutefois, il est peu probable que cette intégration seule atteigne la limite de 200 Mo.
   • Fréquence des mises à jour complètes :
     • Un flux marchands complet est fourni une fois par jour.
     • (Si implémenté) Un flux services complet est fourni 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, vous recevrez un e-mail contenant les codes d'erreur enregistrés dans le flux.

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 vérifions les éléments suivants :

• Le flux respecte les spécifications.
• Le flux inclut tous les champs obligatoires.
• Au moins un action_link ou un service avec au moins action_link a été défini pour chaque marchand.
• La majorité de vos données marchand correspondent à des adresses sur Google Maps.

Remarque : Pour assurer une intégration fluide, pré-évaluez les différents facteurs ci-dessus (à l'exception du dernier) avant d'envoyer vos flux.