引导流程

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

图 1：新手入门流程

新手入门流程包括三个阶段：

1. 设置 - 账号配置和开发流程规划。
2. 开发 - 数据 Feed 开发和测试。
3. 发布 - 发布前的数据评估。

设置

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

在合作伙伴门户上访问您的账号，然后前往 Dropbox 配置页面 Configuration > Feeds。与菜单数据 Feed 集成相关的两个下拉菜单分别是通用和商家。请检查两个 Dropbox 是否都已配置 SSH 公钥。如需详细了解如何配置 SSH 密钥，请参阅此页面。

注意：如果您的账号已启用 OwG 重定向或 RwG 集成，则实体 Feed 或商家应该已针对该集成全面实现。 确保菜单 Feed 中的所有餐厅都已在实体 Feed 或商家 Feed 中列出。

通用 DropBox 可以接受遵循不同数据架构的各种 Feed。接受结构化菜单数据的 Feed 类型名为 google.food_menu，在您开始使用此功能时，系统通常会默认为您的账号启用此 Feed。如果您在尝试提交 Feed 时看到以下错误消息 - “Feed 处理失败。我们在解析您的 Feed 时遇到了内部问题。“google.food_menu”未启用。请修正并重试。”，请与您的 Google 联系人联系以启用此 Feed 类型。

最后，请前往配置 > 联系信息页面，确保您的所有详细联系信息均是最新的。

开发

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

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

图 2：Feed 提取结果

注意：google.food_menu Feed 依赖于商家 Feed，以便将静态菜单数据与正确的餐厅相关联。确保商家 Feed 中的条目与 Google 数据源中的餐厅记录一致。如需了解详情，请参阅商家匹配和测试以及匹配准则一文。

发布

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

发布前提条件

必须满足以下条件，集成才能启动：

• 数据 Feed 在生产环境中处理，且没有错误。
• 正式版数据 Feed 包含在集成开始时为此集成指定的完整商品目录范围。
• 您的大多数商家数据都与 Google 地图上的营业地点信息相匹配。
• 正式版 Feed 通过了数据质量评估。
• 此集成符合所有食品菜单政策和要求。

数据评估

在成功提取没有错误的正式版数据 Feed 后，系统可能会执行一项内部流程来评估菜单数据的质量。此流程旨在发现数据质量不一致的问题，例如菜肴说明中包含与食品无关的内容、菜肴名称不一致、价格不一致等。如果发现此类问题，我们会与开发团队分享反馈。