Cet article explique comment activer l'API de menu pour votre compte et l'intégrer. Vous trouverez ci-dessous une présentation détaillée du processus d'intégration et des conditions préalables au lancement. Veuillez vous reporter à cette page lorsque vous planifiez l'effort d'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.
Préparation
À ce stade, il est important de vérifier que votre compte sur le portail des partenaires est entièrement configuré et prêt à accepter les flux de données pertinents pour les données de menu statiques. Si vous avez déjà une intégration OwG Redirect ou RwG active à laquelle vous ajoutez les métadonnées du menu, votre compte existant sera réutilisé pour cette intégration. Si l'intégration avec OwG Direct sur cette plate-forme est désactivée ou si aucune intégration n'est proposée, un compte est créé et les informations d'accès sont partagées par e-mail.
Accédez à votre compte sur le portail des partenaires, puis à la page de configuration de la boîte de dépôt Configuration > Flux. Deux boîtes de dépôt sont pertinentes pour l'intégration des flux de données de menu : Generic (Générique) et Merchants (Marchands). Veuillez vérifier que la clé publique SSH est configurée sur les deux boîtes de dépôt. Pour en savoir plus sur la configuration des clés SSH, consultez cette page.
La boîte de dépôt générique peut accepter plusieurs flux pouvant suivre différents schémas de données. Le type de flux qui accepte 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 tentez d'envoyer un flux et que le message d'erreur suivant s'affiche : "Échec du traitement du flux. Un problème interne s'est produit lors de l'analyse de votre flux. "google.food_menu" n'est pas activé. Veuillez corriger et réessayer.", veuillez vous adresser à votre contact Google pour activer ce type de flux.
Enfin, accédez à la page Configuration > Contact Information (Configuration > Coordonnées) et assurez-vous que toutes vos coordonnées sont à jour.
Development
La phase de développement constitue la principale partie de l'implémentation, qui consiste à générer et à tester les flux de données. Les flux de données doivent être créés et envoyés tous les jours au compte "Envoi sécurisé" cible. Le traitement des flux envoyés dans le bac à sable commence généralement dans l'heure qui suit leur envoi. Les flux de production sont traités une fois par jour à midi (heure normale du Pacifique). Seul le dernier flux envoyé est récupéré pour être traité. Veuillez consulter les spécifications et les exemples associés aux flux de données lorsque vous les générez. 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 de résoudre les problèmes. 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 de validation de flux, qui vérifie si le fichier correspond aux spécifications. L'outil indique si le fichier correspond au schéma de données et, dans le cas contraire, 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, affichez les résultats sur le portail des partenaires. Pendant l'ingestion du flux, des règles de validation supplémentaires sont appliquées afin de tester une partie de la logique métier et la qualité des données.
Lancement
La phase de lancement peut être lancée une fois que tout le travail d'intégration est terminé et que le flux de production reflète correctement l'intégralité de l'inventaire des menus du restaurant.
Conditions préalables pour le 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 erreur.
- Le flux de données de production contient l'inventaire complet limité à 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 du menu alimentaire.
Évaluation des données
Une fois que les flux de données de production ont été ingérés sans erreur, un processus interne peut être mis en place pour évaluer la qualité des données du menu. Ce processus vise à détecter les incohérences dans la qualité des données, telles que les contenus non alimentaires dans les descriptions des plats, les noms des plats incohérents, les prix, etc. Dans ce cas, les commentaires seront transmis à l'équipe de développement.