Créez des flux
Les flux doivent être envoyés à Google régulièrement 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. | Toutes les 24 heures |
| Services | Décrit les services fournis par vos marchands | Toutes les 24 heures |
| Disponibilité | Emplacements disponibles pour les services fournis par vos marchands. Vous devez disposer d'une couverture minimale de 30 jours. | Toutes les 24 heures |
Dans chaque flux, incluez des métadonnées qui indiquent à Google comment l'interpréter.
Le format des flux est décrit avec 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 concernant 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 pour le flux :
- Flux marchands : 1 segment
- Flux services : 1 segment
- Flux disponibilité : moins de 20 segments
- Taille des fichiers de flux et de la segmentation :
- Assurez-vous que la taille du fichier segmenté ne dépasse pas 200 Mo (après compression). Utilisez plusieurs segments si nécessaire.
- Les enregistrements individuels envoyés dans un segment ne doivent pas nécessairement l'être dans le même segment dans les flux à venir.
- Pour de meilleures performances, répartissez les données de manière égale entre les segments, afin que la taille de tous les fichiers de partition soit similaire.
- Si nécessaire, utilisez gzip pour compresser les flux au format JSON texte brut. Toutefois, cette opération doit être effectuée pour chaque segment du flux.
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 indiqués sur la page Configuration du 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 d'interroger l'état du flux.
Vérifier l'exactitude de vos données
Connectez-vous au portail des partenaires. Basculez vers l'environnement Sandbox pour trouver les pages suivantes dans la section Tableaux de bord.
- Flux
- Présente les statistiques récapitulatives du flux et indique les erreurs détectées lors de son importation.
Pour vérifier que vos données s'affichent correctement après votre importation initiale dans l'environnement de bac à sable, consultez la page Flux. Consultez ensuite la page Inventory Summary (Récapitulatif de l'inventaire) pour identifier les éventuels problèmes de données. Les problèmes courants incluent l'importation de marchands sans service ou l'importation de services sans disponibilité future.
L'interface du bac à sable, qui émule l'interface utilisateur en direct, montre comment les données apparaîtront 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 et accédez à Inventaire > Inventaire, recherchez un marchand qui est "Prêt" ou "En ligne (dans Sandbox)", puis cliquez sur le lien situé dans la colonne la plus à droite (si disponible) ou sur la ligne, puis cliquez sur le lien "RwG - E2E". Si aucun marchand ne présente 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 répertoriés à droite (par exemple, pour vous assurer que la disponibilité future sera importée).
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. Vérifiez é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 serez toujours bloqué sur 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 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 mise en ligne.
Veuillez importer un flux marchand complet dès que possible (au moins une semaine avant le lancement) afin de pouvoir associer vos marchands à 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 de manière cohérente 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 les flux correspond à celui discuté avec Google.
- Au moins un service est défini pour chaque marchand.
- Le nombre total de services dans les flux correspond à celui discuté 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.