Les flux fournissent vos données d'inventaire à Actions Center. Cette importation quotidienne via le protocole SFTP (Secure File Transfer Protocol) met à jour toutes les données des marchands, des services et des créneaux de disponibilité. Les flux indiquent les marchands que vous acceptez, leur disponibilité et les fonctionnalités spéciales requises pour confirmer que Google affiche correctement votre inventaire. Les flux sont importés dans les boîtes de dépôt SFTP configurées lorsque vous fournissez votre clé SSH dans Configuration.
Vous devez effectuer les tâches suivantes dans Feeds Ready avant de passer au serveur de réservation :
Les tâches seront marquées comme terminées et deviendront vertes une fois que vous aurez importé vos flux. Consultez la documentation associée pour effectuer chaque tâche spécifique.
Pour que votre intégration de bout en bout des réservations de restaurants fonctionne correctement, vous devez fournir des importations automatiques quotidiennes de flux de marchands, de services et de disponibilités. Votre infrastructure de flux automatisée doit fournir l'intégralité de votre inventaire.
Types de flux
Les intégrations de bout en bout de réservations de restaurants nécessitent les flux suivants et leurs fréquences d'importation :
| Flux | Description | Fréquence | Échantillon |
|---|---|---|---|
| Marchand | Décrit vos marchands. | Une fois toutes les 24 heures | Exemple de flux de marchand |
| Services | Décrivez les services de vos marchands. | Une fois toutes les 24 heures | Exemple de flux de services |
| Disponibilité | Décrit les créneaux disponibles pour les services de vos marchands. Vous devez fournir une couverture d'au moins 30 jours. Pour étendre la couverture à 90 jours, contactez l'assistance Google via le formulaire de contact du Centre d'actions. | Une fois toutes les 24 heures | Exemple de flux de disponibilité |
Les formats de flux sont décrits à l'aide de la syntaxe du Protocol Buffer 3, mais vous pouvez importer vos flux au format JSON correspondant. Consultez les exemples de flux pour le format JSON. Nous vous recommandons d'importer les flux au format JSON.
Conventions de dénomination et métadonnées
Noms des fichiers
Si vous utilisez le partitionnement, les flux que vous importez doivent avoir des noms uniques qui spécifient le type et le nombre de flux. Un code temporel pour la génération du flux répond à l'exigence d'unicité du nom de fichier de votre flux.
Structure : {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
Exemple : availability_feed_1574117613_001_of_002.json.gz
Définir des ID
Lorsque vous définissez des ID pour vos marchands ou d'autres attributs qui en nécessitent un, nous vous recommandons vivement d'utiliser des UID ou des UUID. Vous pouvez fournir votre propre solution alphanumérique, à condition que les ID restent distincts sur votre plate-forme.
Métadonnées
Lorsque vous créez des flux, le generation_timestamp doit refléter le moment où les données ont été extraites de la base de données. La réutilisation de cette valeur dans plusieurs flux peut entraîner des erreurs de traitement.
Les valeurs de nonce, qui sont des nombres aléatoires ou non répétitifs, doivent être uniques pour tous les types de flux et ne peuvent pas être réutilisées. La valeur doit être identique pour tous les fichiers du flux segmenté spécifique.
Taille du fichier de flux
Segmenter les fichiers des flux
En fonction de votre inventaire, il peut être nécessaire de fragmenter les flux en plusieurs fichiers. Vous devrez peut-être fragmenter vos flux dans les cas suivants :
- La taille compressée d'un fichier de flux gzip dépasse 200 Mo.
- Exemple : le flux de disponibilité généré est de 1 Go. Il doit être fragmenté en cinq fragments distincts ou plus.
- L'inventaire des partenaires est distribué entre plusieurs systèmes ou régions, ce qui rend difficile la réconciliation de l'inventaire.
- Exemple : un partenaire dispose d'un inventaire aux États-Unis et dans l'UE, qui se trouve dans des systèmes distincts.
Le flux peut être généré avec deux partitions. Une pour les États-Unis et une pour l'UE avec le même nonce et le même
generation_timestamp.
- Exemple : un partenaire dispose d'un inventaire aux États-Unis et dans l'UE, qui se trouve dans des systèmes distincts.
Le flux peut être généré avec deux partitions. Une pour les États-Unis et une pour l'UE avec le même nonce et le même
Pour en savoir plus, consultez Tutoriels et bonnes pratiques concernant le partitionnement des fichiers de flux.
Un flux peut comporter plusieurs fichiers appelés segments. Pour déterminer la taille des flux, suivez les consignes suivantes :
- Segmentation suggérée pour chaque flux :
- Flux marchands : un segment.
- Flux services : un segment.
- Flux de disponibilité : moins de 20 segments. Si vous avez une justification commerciale qui nécessite un montant supérieur à celui spécifié, contactez l'assistance pour obtenir des instructions supplémentaires.
- Taille des fichiers et de la segmentation des flux :
- 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 pour chaque fragment de flux.
Compresser les fichiers de flux
Vous pouvez compresser n'importe quel fichier JSON ou PB3 avec gzip avant de l'importer. Cela peut réduire considérablement la taille en octets des flux quotidiens.
Chaque fichier shard doit être compressé au format gzip et importé individuellement (par exemple, gzip*.json). Les fragments de flux compressés doivent se terminer par .json.gz ou .pb3.gz.
Importer les flux dans votre boîte de dépôt SFTP
Une fois que vous avez généré les flux marchands, de services et de disponibilité, vous pouvez les importer dans l'environnement de bac à sable ou de production via la boîte de dépôt SFTP. La boîte de dépôt SFTP est configurée lorsque vous fournissez votre clé SSH dans la configuration.
Le serveur SFTP de Google est disponible à l'adresse sftp://partnerupload.google.com sur le port 19321.
Google examine et valide 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é entre plusieurs fichiers, il est traité après l'importation du dernier fichier. Si votre flux contient des erreurs, un e-mail contenant des codes d'erreurs enregistrées dans le flux vous est envoyé. Les erreurs empêchent l'ingestion des marchands, des services ou des disponibilités définis. Une fois les flux validés, il peut s'écouler jusqu'à 24 heures avant qu'ils s'affichent sur l'interface utilisateur.