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 元数据,告诉 Google 如何解读该 Feed。

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

    "metadata": {
     "generation_timestamp": "1467993600",
     "processing_instruction": "PROCESS_AS_COMPLETE",
     "total_shards": 1
    }
    
  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 进行评估

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

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