Fournir des données de menu structurées

Les partenaires Google peuvent fournir à Google des données de menu structurées via l'intégration de Réserver avec Google dans la section Menu de la fiche d'un restaurant sur Google Maps pour mobile (Android et iOS).

Les données de menu sont ingérées via votre intégration Réserver avec Google existante à l'aide d'une fonctionnalité appelée flux génériques. Avant de commencer, assurez-vous d'avoir terminé la configuration du compte et lisez l'article Utiliser la boîte de dépôt du flux générique pour obtenir un aperçu du processus d'importation de flux génériques et pour comprendre comment configurer votre compte pour les importations de flux génériques.

Créer et importer des flux de menu

Lorsque vous créez et importez des flux de menu, tenez compte des points suivants:

  • Suivez les spécifications décrites dans le flux de menu pour les fichiers de données de menu. Pour obtenir un exemple de fichier de données de menu, reportez-vous à l'exemple JSON de flux de menu. Le nom des fichiers de données de menu doit être unique entre les importations. Nous vous recommandons d'inclure un horodatage dans le nom du fichier, par exemple menu1_1633621547.json.
  • Dans le descripteur de l'ensemble de fichiers, définissez le champ name sur google.food_menu. Pour obtenir un exemple de fichier de descripteur, reportez-vous à l'exemple JSON de fichier de descripteur. Les noms de fichiers des descripteurs doivent être uniques entre les importations. Nous vous recommandons d'inclure un horodatage dans le nom du fichier, par exemple descriptor_1633621547.filesetdesc.json. Le fichier descripteur doit être importé dans la boîte de dépôt SFTP générique dans le cadre du flux du menu.
  • Les flux de menu doivent être importés tous les jours dans la boîte de dépôt SFTP générique sous forme d'actualisations complètes.
  • Respectez les spécifications décrites dans le flux de marchands pour les fichiers de flux de marchands. Pour obtenir un exemple de fichier de flux marchands, consultez l'exemple de flux JSON pour les marchands. Nous vous recommandons d'inclure un horodatage dans le nom du fichier, par exemple merchant1_1633621547.json.
  • Les flux marchands doivent être importés quotidiennement dans la boîte de dépôt SFTP des marchands, sous la forme d'actualisations complètes.
  • Pour en savoir plus sur le menu et la boîte de dépôt SFTP des flux marchands, accédez à la section Configuration > Flux du portail des partenaires.
  • Sélection des boîtes de dépôt du flux

  • Le menu et l'état d'ingestion des flux marchands sont disponibles dans la section Flux > Historique du portail des partenaires.

Utiliser les options des éléments de menu

Vous pouvez spécifier les options des éléments de menu à l'aide du protocole MenuItemOption. Les options de l'élément de menu s'affichent sous la forme d'une liste plate. Consultez l'exemple ci-dessous.

Éléments du menu de tarification avec options

Figure 1 : Bâtonnets de pain

Seules les options d'éléments de menu obligatoires sont acceptées. Une option de menu obligatoire est une option que le client doit choisir lors de la commande. Par exemple, la taille d'une pizza est une option obligatoire. Les options d'éléments de menu facultatives (option d'ajout d'avocat, par exemple) ne sont pas acceptées.

Étant donné que les options d'éléments de menu sont affichées sous forme de liste unique, les partenaires disposant de plusieurs ensembles d'options obligatoires pour un seul élément de menu (par exemple, un latte avec des options de taille et de lait) doivent choisir la meilleure façon d'afficher ces options dans Google. Google recommande les méthodes heuristiques suivantes:

  • Si un seul ensemble d'options obligatoire affecte le prix, préférez l'inclure dans les flux.
  • Dans tous les autres cas, il appartient au partenaire de déterminer la meilleure façon de représenter les options des éléments de menu. Il n'est pas recommandé de créer de longues listes d'options pour toutes les combinaisons possibles.

Lorsque vous incluez des options d'éléments de menu sous un élément de menu:

  • L'élément de menu doit contenir au moins une offre avec un prix (dans les cas où les options de l'élément de menu n'affectent pas le prix).
  • L'élément de menu doit comporter un ensemble d'options dont le prix est identique au prix total de l'élément sélectionné.

Le prix doit uniquement être fourni pour l'article du menu ou pour ses options, mais pas pour les deux.