Google 合作伙伴可以通过预订端到端集成向 Google 提供结构化菜单数据,以便在 Google 地图移动版(Android 和 iOS)上餐厅商家信息页的菜单部分中使用。
系统会使用通用 Feed 提取菜单数据。在开始之前,请花几分钟时间确保您已完成账号设置步骤,并阅读使用通用 Feed Dropbox 一文,了解通用 Feed 上传流程概览以及如何配置账号以进行通用 Feed 上传。
创建和上传菜单 Feed
创建和上传菜单 Feed 时,请注意以下事项:
-
请按照菜单 Feed 中所述的数据规范生成菜单数据文件。菜单数据文件名在每次上传时都应是唯一的。建议在文件名中添加时间戳,例如
menu1_1633621547.json
。 -
在文件集描述符中,将
name
字段设置为google.food_menu
。如需查看描述符文件内容示例,请参阅描述符文件 JSON 示例。描述符文件的名称在每次上传时都应是唯一的。建议在文件名中添加时间戳,例如descriptor_1633621547.filesetdesc.json
。 描述符文件应作为菜单 Feed 的一部分上传到通用 SFTP Dropbox。 - 菜单 Feed 应每天作为完整刷新上传到通用 SFTP Dropbox。
- 您可以在合作伙伴门户的配置 > Feed 部分找到 Feed SFTP Dropbox 信息。
使用菜单项选项
您可以使用 MenuItemOption
proto 指定菜单项选项。菜单项选项会以扁平列表的形式显示在菜单项下方。请参阅下面的示例。
仅支持必需菜单项选项。必需的菜单项选项是指客户在下单时必须选择的选项。例如,在订购披萨时,尺寸是必选选项。 不支持可选的菜单项选项(例如“添加鳄梨的选项”)。
由于菜单项选项会显示为单个扁平列表,因此如果合作伙伴为单个菜单项提供了多组必需选项(例如,提供大小选项和牛奶选项的拿铁),则必须决定如何在 Google 中最好地显示这些选项。Google 建议遵循以下启发词语:
- 如果只有一组必需选项会影响价格,请尽量在 Feed 中添加该选项组。
- 对于所有其他情况,合作伙伴可以自行决定如何最好地显示菜单项选项。不建议为所有可能的选项组合创建长长的选项列表。
在菜单项下添加菜单项选项时,请执行以下操作之一:
- 菜单项必须至少包含一项带有价格的商品(如果菜单项选项不会影响价格)。
- 菜单项必须包含一组选项,并且每个选项的价格都设置为选择该选项时商品的总价格。
价格应仅针对菜单项或其选项提供,不能同时针对这两者提供。
如何查看菜单
菜单 Feed 发布后,您的菜单 Feed 数据可能会显示在餐厅商家信息的“菜单”标签页中。如果有多个来源为同一家餐厅提供菜单,商家可以在 Google 商家资料菜单编辑器中选择首选提供商。如需详细了解商家如何选择首选菜单提供商,请参阅管理菜单。
以下 Google 平台会在酒店信息页上显示“菜单”标签页:
产品 | 设备 |
---|---|
Google 搜索 | 移动网络 |
Google 搜索 | 移动原生应用 |
Google 地图 | 移动原生应用 |
如需在桌面设备上进行测试,请使用浏览器开发者工具模拟移动设备。
- 在商品目录视图中,选择相应商家,然后点击酒店信息页链接以查看相应餐厅的酒店信息页。
- 打开 Chrome 开发者工具(右键点击“检查”或依次选择“查看”->“开发者”->“开发者工具”),选择移动设备类型 ,然后刷新页面。
最佳做法
以下是开发菜单 Feed 时应遵循的最佳实践。
- 请勿将多个菜单与一家餐厅相关联。
- 在 TextField 中,将首选语言作为第一种语言提供。如果您要发送多个 LocalizedText 对象,目前系统只会向用户显示文本列表中的第一个对象。
- 所有菜单项都应添加到菜单版块中,请勿直接将菜单项添加到菜单对象。
- 使用 utf-8 编码提供内容。无需转义非 ASCII 字符。
- 将 Feed 文件或分片数限制为 1,000 个,如使用通用的 Feed Dropbox 中所述。