Créez des flux :
Vous devez fournir régulièrement des flux à Google pour que les données soient diffusées 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é | Créneaux disponibles pour les services fournis par vos marchands. Vous devez fournir une couverture d'au moins 30 jours. | Une fois toutes les 24 heures |
Indiquez à Google comment interpréter votre flux en y incluant des métadonnées.
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 voir 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 fragments :Pour déterminer la taille des flux, tenez compte des consignes suivantes (notez qu'un flux peut comprendre plusieurs fichiers appelés "segments"):
- Segmentation suggérée pour chaque 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 ne doivent pas nécessairement être envoyés 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 segmentés soit la même.
- Si nécessaire, utilisez gzip pour compresser les flux au format JSON texte brut. Toutefois, faites-le pour chaque segment de vos flux.
Importer les flux dans votre boîte de dépôt SFTP
Importez vos flux dans l'environnement de bac à sable. Pour ce faire, reportez-vous aux noms d'utilisateur affichés 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 l'horodatage à chaque nom de fichier. Cela peut vous aider lorsque vous devez résoudre des problèmes ou lancer une requête sur l'état du flux.
Vérifier l'exactitude de vos données
Connectez-vous au portail des partenaires. Passez à l'environnement de bac à sable afin de rechercher les pages suivantes dans la section Dashboards (Tableaux de bord).
- Flux
- Affiche un récapitulatif des statistiques du flux et signale toute erreur enregistrée lors de l'importation du flux.
Pour vérifier l'exactitude de vos données après votre importation initiale dans l'environnement de bac à sable et détecter d'éventuelles erreurs, consultez la page Flux. Consultez ensuite la page Inventory Summary (Récapitulatif de l'inventaire) pour identifier les éventuels problèmes de données. Ceux-ci incluent par exemple l'importation de marchands sans aucun service ou l'importation de services sans aucun créneau disponible dans le futur.
L'interface de l'environnement de bac à sable, qui est une émulation de l'interface utilisateur publique, vous permet d'afficher 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 "Bac à sable", puis accédez à Inventaire > Inventaire , recherchez un marchand dont l'état est "Prêt" ou "En service (dans le bac à sable)", puis cliquez sur le lien dans la colonne la plus à droite (le cas échéant) ou sur la ligne, puis sur le lien "RwG - E2E". Si aucun marchand n'a l'état "Prêt" ou "En ligne (dans l'environnement bac à sable)", ouvrez un marchand désactivé et assurez-vous de résoudre tous les problèmes listés à droite (par exemple, vérifiez que les disponibilités futures ont été importées).
Si vous ne parvenez pas à accéder à l'interface du bac à sable, vérifiez que vous êtes connecté via un compte disposant des droits d'accès. 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é de changement 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
Lorsque vous arrivez au point de pouvoir 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 n'est pas encore publiée.
Veuillez importer un flux de marchands complet dès que possible (au moins une semaine avant le lancement), afin de commencer à faire correspondre vos marchands à une fiche d'établissement Google. Veuillez vérifier que la correspondance est correcte.
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 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 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 30 prochains jours.
- Nous vérifions combien de marchands peuvent être mis en correspondance avec des éléments géographiques sur Google Maps.