Cet article explique comment activer l'API de menu pour votre compte et l'intégrer. Vous trouverez ci-dessous un aperçu détaillé du processus d'intégration et des conditions préalables au lancement. Veuillez vous reporter à cette page lorsque vous planifiez l'intégration.
- Configuration : configuration du compte et planification du processus de développement.
- Développement : développement et test du flux de données.
- Lancement : évaluation des données avant le lancement.
Configuration
À ce stade, il est important de vérifier que votre compte sur le Partner Portal est entièrement configuré et prêt à accepter les flux de données pertinents pour les données de menu statiques. Si vous disposez d'une intégration OwG Redirect ou RwG active à laquelle vous ajoutez les métadonnées des menus, votre compte existant sera réutilisé pour cette intégration. En cas d'intégration OwG Direct sur cette plate-forme ou d'absence d'intégration, un nouveau compte est créé et les informations d'accès sont partagées par e-mail.
Accédez à votre compte sur le Partner Portal, puis accédez à la page de configuration de la boîte de dépôt : Configuration > Flux. Deux listes déroulantes sont disponibles pour l'intégration du flux de données de menu : Générique et Marchands. Veuillez vérifier que la clé publique SSH est configurée pour les deux "Envoi sécurisé". Pour en savoir plus sur la configuration des clés SSH, consultez cette page.
La dropbox générique peut accepter différents flux qui peuvent suivre différents schémas de données. Le type de flux acceptant les données de menu structurées est nommé google.food_menu. Il est généralement activé par défaut pour votre compte au début de votre intégration. Si vous essayez d'envoyer un flux et que le message d'erreur suivant s'affiche :
"Le traitement du flux a échoué. Un problème interne s'est produit lors de l'analyse de votre flux. "google.food_menu" n'est pas activé. Veuillez corriger le problème et réessayer.", veuillez contacter votre contact Google pour activer ce type de flux.
Enfin, accédez à la page Configuration > Coordonnées et assurez-vous que toutes vos coordonnées sont à jour.
Développement
La phase de développement contient la majeure partie de l'effort d'implémentation : générer et tester les flux de données. Les flux de données doivent être créés et envoyés à la boîte de dépôt cible tous les jours. Le traitement des flux envoyés dans l'environnement bac à sable devrait commencer dans l'heure suivant l'envoi. Les flux de production sont traités une fois par jour à midi, heure du Pacifique. Seul le dernier flux envoyé est traité. Veuillez vous reporter aux spécifications et aux exemples du flux de données lorsque vous générez vos flux. Bien que la spécification soit présentée au format protobuf, nous vous recommandons d'importer les fichiers de flux au format JSON, car il est plus facile à résoudre. C'est pourquoi les exemples de flux sont également fournis au format JSON.
Vous pouvez tester rapidement un fichier de flux de données à l'aide de l'outil en ligne Feed Validator, qui vérifie si ce fichier correspond aux spécifications. L'outil indique si le fichier correspond au schéma de données. Si ce n'est pas le cas, il génère la liste des erreurs. Pour tester un flux de données complet composé de plusieurs fichiers, importez-le dans l'environnement de bac à sable. Une fois l'ingestion terminée, consultez les résultats sur le Partner Portal. Lors de l'ingestion du flux, des règles de validation supplémentaires sont appliquées pour tester certaines logiques métier et la qualité des données.
Lancer
L'étape de lancement peut être lancée une fois que toutes les tâches d'intégration sont terminées et que le flux de production reflète correctement l'ensemble de l'inventaire des menus des restaurants.
Conditions préalables au lancement
Les conditions suivantes doivent être remplies pour que l'intégration soit lancée:
- Les flux de données sont traités dans l'environnement de production sans aucune erreur.
- Le flux de données de production contient l'inventaire complet défini pour cette intégration au début de celle-ci.
- La majorité de vos données marchand correspondent à des adresses sur Google Maps.
- Les flux de production ont réussi l'évaluation de la qualité des données.
- L'intégration respecte toutes les Règles et exigences concernant les menus de restaurants.
Évaluation des données
Une fois les flux de données de production ingérés sans erreur, un processus interne peut être mis en place pour évaluer la qualité des données de menu. Ce processus vise à détecter les incohérences dans la qualité des données, telles que du contenu non lié à la nourriture dans les descriptions des plats, des noms de plats ou des prix qui ne correspondent pas, etc. En cas de tels résultats, les commentaires seront partagés avec l'équipe de développement.