É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 de marchands (et votre flux de services, le cas échéant):

   • Flux marchands:ce flux décrit vos marchands et les liens d'action au niveau des marchands.
   • Flux services (facultatif / non recommandé) : nous vous déconseillons d'implémenter des flux de services pour les nouvelles intégrations avec rendez-vous Business Link. Si vous souhaitez conserver votre intégration existante, suivez cette ancienne documentation.

   Champs obligatoires et recommandés

   Flux	Nom du champ	Description	Obligatoire ?
   Marchands	merchant_id	Identifiant unique du marchand	Oui
   Marchands	name	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	category	Type de lieu associé au marchand	Souhaitable
   Marchands	action_link	Informations concernant les liens profonds spécifiques au marchand	Oui
   Marchand	action_link_type
   Marchand	brand_id	Chaîne identifiant la marque à utiliser auprès des consommateurs	Facultatif

   Remarque:Vous devez ignorer tous les champs supplémentaires décrits dans la section de référence.
   Important:Vous ne devez importer que le flux marchand.

   Pour commencer, consultez les exemples de flux

   • Exemples de flux (rendez-vous en personne)

   Pour en savoir plus sur la spécification de liens d'action dans les flux d'intégration de Rendez-vous Business Link, cliquez ici.

   Incluez dans chacun de vos flux des métadonnées 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:Tous les flux doivent être importés avec l'instruction traitement 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 conjointement avec l'intégration de bout en bout Actions Center ou en tant que module complémentaire de l'intégration de bout en bout. Pour ce faire, vous devrez également implémenter les flux disponibilité et les champs obligatoires pour l'intégration de bout en bout, conformément à ce guide.

2. Exportez vos flux. Le format des flux est décrit à l'aide de la syntaxe du tampon de protocole 3, mais vous pouvez faire référence aux 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 et obtenir des informations générales sur l'utilisation des tampons de protocole pour générer un fichier pb3, consultez la page Protocol Buffer Basics: Java.

3. Importez les flux dans votre boîte de dépôt SFTP. Pour importer vos flux, utilisez les informations sur la boîte de dépôt 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, un nom comprenant un horodatage). L'utilisation de noms uniques facilite le dépannage et permet d'interroger l'état du flux.

   Pour déterminer la taille des flux et la fréquence de diffusion, respectez les consignes suivantes:

   • Taille des fichiers et segments du flux :
     • La taille du fichier de flux ne doit pas dépasser 200 Mo (après compression). Les compresser avec gzip
     • Si votre fichier peut dépasser 200 Mo (après compression), divisez-le en plusieurs segments en suivant le tutoriel Diviser les fichiers de flux . Cependant, il est peu probable que cette intégration seule atteigne la limite de 200 Mo.
   • Fréquence des mises à jour complètes :
     • Un flux marchand complet est fourni une fois par jour.
     • (Si implémenté) Un flux de service complet est fourni une fois par jour.
   Remarque:Google traite les fichiers de flux dès qu'ils sont importés dans la boîte de dépôt 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 recevez un e-mail contenant les codes d'erreur du flux.

Google évalue les flux

Une fois que vous avez importé vos flux, Google les traite et les évalue pour en vérifier la qualité et l'exhaustivité. Nous vérifions les éléments suivants :

• Le flux respecte les spécifications.
• Le flux inclut tous les champs obligatoires.
• Chaque marchand dispose d'au moins un action_link ou d'un service avec au moins action_link défini(e).
• La majorité de vos données marchand correspondent à des adresses sur Google Maps.

Remarque:Pour garantir une intégration fluide, effectuez une pré-évaluation des facteurs ci-dessus (à l'exception du dernier) avant d'envoyer vos flux.