Créez des flux
Les flux doivent être envoyés régulièrement à Google pour que les données s'affichent directement sur Google. Les flux suivants sont nécessaires.
| Flux | Description | Fréquence |
|---|---|---|
| Marchands | Décrit vos marchands. | Une fois toutes les 24 heures |
| Services | Décrit les services fournis par vos marchands | Une fois toutes les 24 heures |
| Disponibilité | Emplacements disponibles pour les services fournis par vos marchands. Vous devez fournir une couverture d'au moins 30 jours. | Une fois toutes les 24 heures |
Dans chaque flux, incluez des métadonnées qui indiquent à Google comment les interpréter.
Le format des flux est décrit à l'aide de la syntaxe du Protocol Buffer 3, mais vous pouvez importer vos flux au format JSON correspondant. Veuillez consulter les exemples de flux pour connaître le format JSON. Nous vous recommandons d'importer les flux au format JSON.
Taille, segmentation et compression des fichiers de flux
Veuillez consulter les tutoriels suivants sur la compression et les segments :Pour déterminer la taille des flux, respectez les consignes suivantes (un flux peut être constitué de plusieurs fichiers appelés "segments"):
- Segmentation suggérée des flux :
- Flux marchands : 1 segment
- Flux services : 1 segment
- Flux disponibilité : moins de 20 segments
- Taille des fichiers de flux et segmentation :
- Assurez-vous que la taille du fichier segmenté ne dépasse pas 200 Mo (après compression). Si nécessaire, utilisez plusieurs segments.
- Les enregistrements individuels envoyés dans un segment n'ont pas besoin d'être envoyés dans le même segment dans les futurs flux.
- Pour de meilleures performances, répartissez les données de manière égale entre les segments, afin que la taille de tous les fichiers segmentés soit similaire.
- Si nécessaire, utilisez gzip pour compresser les flux au format JSON texte brut. Toutefois, faites-le pour chaque segment de flux individuel.
Importer les flux dans votre compte "Envoi sécurisé" SFTP
Importez vos flux dans l'environnement de bac à sable. Pour ce faire, reportez-vous aux noms d'utilisateur sur la page de configuration des flux du portail des partenaires. Le serveur SFTP de Google est disponible à l'adresse sftp://partnerupload.google.com sur le port 19321.
Nous vous recommandons d'attribuer des noms uniques aux fichiers que vous importez. Par exemple, il peut être utile d'ajouter un horodatage à chaque nom de fichier. Cela permet de résoudre les problèmes et de demander l'état du flux.
Vérifier l'exactitude de vos données
Connectez-vous au portail des partenaires. Passez à l'environnement Bac à sable pour accéder aux pages suivantes dans la section Tableaux de bord.
- Flux
- Affiche un récapitulatif des statistiques du flux et signale les erreurs survenues lors de son importation.
Pour vérifier que vos données sont correctes après votre importation initiale dans l'environnement de bac à sable, consultez la page Flux pour identifier d'éventuelles erreurs de flux. Consultez ensuite la page Inventory Summary (Récapitulatif de l'inventaire) pour identifier les problèmes de données. Les problèmes courants incluent l'importation de marchands sans aucun service ou l'importation de services sans créneaux de disponibilité à l'avenir.
L'interface de bac à sable, qui émule l'interface utilisateur active, montre à quoi ressembleront les données du point de vue de l'utilisateur. Pour y accéder, assurez-vous que le sélecteur d'environnement en haut de la page est défini sur "Sandbox". Accédez à Inventaire > Inventaire , recherchez un marchand associé à l'état "Ready" ou "Live (in Sandbox)", puis cliquez sur le lien dans la colonne la plus à droite (si disponible) ou sur la ligne, puis sur le lien "RwG - E2E". Si aucun marchand n'est associé à l'état "Prêt" ou "En ligne (dans le bac à sable)", ouvrez un marchand désactivé et assurez-vous de résoudre tous les problèmes listés à droite (par exemple, en vous assurant que les disponibilités futures ont été importées).
Si vous ne pouvez pas accéder à l'interface du bac à sable, vérifiez que vous êtes connecté avec un compte autorisé à y accéder. Assurez-vous également qu'il s'agit du seul compte auquel vous êtes connecté. Si vous vous connectez avec un autre compte, puis utilisez la fonctionnalité Changer d'utilisateur pour vous connecter au compte Google approuvé, vous n'aurez toujours pas accès à l'interface du bac à sable.
Importer vos flux en production
Une fois que vous êtes en mesure d'importer régulièrement des flux complets et sans erreur dans l'environnement de bac à sable, vous pouvez commencer à les importer dans l'environnement de production. À ce stade, votre intégration ne sera pas publiée.
Veuillez importer un flux marchands complet dès que possible (au moins une semaine avant le lancement) pour pouvoir commencer à mettre en correspondance vos marchands avec une fiche d'établissement Google. Veuillez vérifier l'exactitude de la correspondance.
Une fois que toutes les données de votre flux de production sont importées régulièrement et connectées à votre système de production, vos flux sont prêts à être examinés.
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 qui lui sont associées.
- Le flux comprend tous les champs obligatoires.
- Le nombre total de marchands dans le flux correspond au nombre sur lequel vous vous êtes mis d'accord avec Google.
- Au moins un service est défini pour chaque marchand.
- Le nombre total de services dans le flux correspond au nombre sur lequel vous vous êtes mis d'accord avec Google.
- Nous vérifions combien de services ont des créneaux de disponibilité ouverts pendant les 1 à 30 prochains jours.
- Nous vérifions combien de marchands peuvent être mis en correspondance avec des éléments géographiques sur Google Maps.