Feed

您需要先创建自己的 Feed，然后由 Google 对其进行评估。

创建 Feed

1. 生成 Feed。您的大部分商品目录数据都通过 Feed 向 Google 传输。首先，请创建您的商家 Feed（以及服务 Feed，如适用）：

   • 商家 Feed：商家 Feed 描述了您的商家与商家级别的操作链接。
   • 服务 Feed（可选 / 不推荐）：不建议为新的起始集成实现服务 Feed。如果您希望维护现有的集成，请按照此旧版文档中的说明操作。

   必填字段和建议填写的字段

   Feed	字段名称	说明	是否必填？
   商家	merchant_id	商家的唯一标识符	是
   商家	name	商家的名称	是
   商家	geo	商家的地址和地理坐标	是
   商家	telephone	商家的电话	是
   商家	category	商家的地点类型	建议填写
   商家	action_link	商家专用深层链接的相关信息	是
   商家	action_link_type [操作链接类型]	关联操作的类型。用餐预订合作伙伴应使用 ACTION_LINK_TYPE_MAKE_DINING_RESERVATION。订餐合作伙伴应参阅订餐外卖与送餐指南。	是
   商家	美食订餐元数据	指定订餐的费用和履单时间。	推荐
   商家	brand_id [品牌 ID]	用于标识要使用的面向消费者的品牌的字符串	选填

   注意：应忽略参考部分中列出的所有其他字段。
   要点：您只需上传商家 Feed。

   首先，请查看示例 Feed

   • 用餐预订 Feed
   • 订餐外卖 Feed
   • 点餐外卖 Feed
   • 包含元数据的订餐 Feed

   如需详细了解如何在起始集成 Feed 中指定操作链接，请点击此处。

   在每个 Feed 中添加 Feed 元数据，告诉 Google 如何解读该 Feed。

   以下是一个 Feed 元数据代码段：

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }
   

   注意：所有 Feed 均必须使用 processing_instruction PROCESS_AS_COMPLETE 上传。PROCESS_AS_INCREMENTAL 已弃用，因此无法使用。
   注意：起始集成还可以与“通过 Google 预订”端到端集成一起实现，或者作为端到端集成的附加实现。为了支持这一点，您还必须按照此指南实现可用性 Feed 和端到端集成必填字段。

2. 导出 Feed。使用 Protocol Buffer 3 语法描述 Feed 格式，但您可以参考上述示例来查看 JSON 格式。我们建议您上传 JSON 格式的 Feed。

   如果您确实想要使用 pb3 格式，有关如何使用协议缓冲区生成 pb3 文件的一般信息，请参阅协议缓冲区基础知识：Java。

3. 将 Feed 上传到 SFTP Dropbox。如需上传您的 Feed，请使用 Google 向您提供的 SFTP Dropbox 信息以及您在设置中创建的私钥。可通过端口 19321 上的 sftp://partnerupload.google.com 访问 Google SFTP 服务器。

   请上传具有唯一名称的文件，例如包含时间戳的名称。唯一名称有助于排查问题，并允许查询 Feed 状态。

   如需确定 Feed 的大小和传送频率，请遵循以下准则：

   • Feed 文件和分片的大小：
     • Feed 文件大小保持在 200MB 以下（压缩后）。使用 gzip 压缩它们
     • 如果文件（压缩后）可能会超过 200MB，请按照分片 Feed 文件教程将其拆分为多个分片。但是，仅入门级集成就不太可能达到 200MB 的上限。
   • 完成更新的频率：
     • 每天提供一次完整的商家 Feed。
     • （如果已实施）每天提供一次完整的服务 Feed。
   注意：Google 会立即将 Feed 文件上传至 SFTP Dropbox。如果 Feed 分片为多个文件，此过程会在上传最后一个文件后开始。如果您的 Feed 包含错误，您会收到一封包含 Feed 错误代码的电子邮件。

Google 对 Feed 进行评估

在您上传 Feed 后，Google 会处理并评估它们的质量和完整性。我们会考虑以下几个因素：

• Feed 符合相关规范。
• Feed 包含所有必填字段。
• 每个商家至少有一项 action_link 或一项服务至少定义了 action_link。
• 您的大多数商家数据都与 Google 地图上的营业地点信息相匹配。

注意：为确保顺利完成集成，请在提交 Feed 之前对上述因素（最后一个因素除外）进行评估。