引导流程

本文介绍了为帐号启用菜单 API 并与其集成的过程。下面详细介绍了新手入门流程和发布前提条件。在规划集成工作时,请参阅此页面。

菜单新手入门流程

图 1:新手入门流程

新手入门流程包括三个阶段:
  1. 设置 - 帐号配置和开发流程规划。
  2. 开发 - 数据 Feed 开发和测试。
  3. 发布 - 发布前的数据评估。

初始设置

在这个阶段,请务必确认合作伙伴门户上的帐号已完全配置,并准备好接受与静态菜单数据相关的数据 Feed。如果您已有有效的 OwG 重定向或 RwG 集成,并且要向其中添加菜单元数据,则您的现有帐号将重复用于此集成。如果在此平台上集成了 OwG 直接集成或根本未集成,系统会创建一个新帐号并通过电子邮件共享访问权限详情。

请在合作伙伴门户中访问您的账号,然后进入 Dropbox 配置页面配置 > Feed。有两个与菜单数据 Feed 集成相关的 Dropbox:通用商家。请确保这两个 Dropbox 都配置了 SSH 公钥。如需详细了解如何配置 SSH 密钥,请参阅此页面

通用 Dropbox 可以接受可遵循不同数据架构的各种 Feed。接受结构化菜单数据的 Feed 类型命名为 google.food_menu,通常在初始配置开始时就为您的帐号默认启用了该类型。如果您在尝试提交 Feed 时看到以下错误消息:“Feed 处理失败。我们在解析您的 Feed 时遇到了内部问题。“google.food_menu”未启用。请解决相应问题,然后重试。”,请与您的 Google 联系人联系,以启用此 Feed 类型。

最后,请前往配置 > 联系信息页面,确保您的所有联系信息都是最新的。

开发

开发阶段包含实现工作的主要部分,即生成和测试数据 Feed。您每天都必须创建数据 Feed 并将其提交到目标 Dropbox。在沙盒中提交的 Feed 应在提交后的一小时内开始处理。正式版 Feed 会在每天中午 12 点(太平洋标准时间)处理一次,系统只会处理最新提交的 Feed。在生成 Feed 时,请参阅数据 Feed 规范示例。虽然该规范以 protobuf 格式提供,但我们建议您以 JSON 格式上传 Feed 文件,因为这样更便于排查问题。因此,我们还提供了 JSON 格式的 Feed 示例

您可以使用 Feed 验证器在线工具快速测试一个数据 Feed 文件,该工具可验证该文件是否符合规范。该工具会显示文件是否与数据架构匹配,如果不匹配,则会输出错误列表。如需测试包含多个文件的整个数据 Feed,请在沙盒环境中上传该 Feed,并在提取完成后前往合作伙伴门户查看结果。在 Feed 提取过程中,系统会应用额外的验证规则来测试某些业务逻辑和数据质量。

Feed 提取结果

图 2:Feed 提取结果

发布

可在所有集成工作完成后启动发布阶段,并且生产 Feed 可正确反映餐厅菜单的整个目录。

启动前提条件

集成必须满足以下条件,才能发布:

  • 数据 Feed 在生产环境中得到处理,且无任何错误。
  • 生产数据 Feed 包含在此集成开始时为该集成确定的完整清单。
  • 您的大部分商家数据都与 Google 地图上的营业地点匹配。
  • 生产 Feed 已通过数据质量评估。
  • 该集成符合所有食品菜单政策和要求

数据评估

在顺利提取生产数据 Feed 后,系统可能会执行一个内部流程来评估菜单数据的质量。此过程旨在发现数据质量不一致的问题,例如菜品说明中包含与食品无关的内容、菜品名称和价格不一致等。如有发现,反馈将与开发团队分享。