第 2 步:Feed

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

创建 Feed

  1. 生成 Feed。大多数商品目录数据都可通过 Feed 传输到 Google。首先,创建商家 Feed(以及服务 Feed,如果适用):

    • 商家 Feed:商家 Feed 对商家进行介绍并提供商家级操作链接。
    • 服务 Feed (可选 / 不推荐):不建议为新的预约商家关联集成实现服务 Feed。 如果您想维护现有的集成,请按照此旧版文档中的说明操作。

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

    Feed 字段名称 说明 是否必填?
    商家 merchant_id 商家的唯一标识符
    商家 name 商家名称
    商家 geo 商家的地址和地理坐标
    商家 电话 商家的电话
    商家 类别 商家的地点类型 建议填写
    商家 action_link 商家专用深层链接的相关信息
    商家 action_link_type
    商家 brand_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 格式,请参阅协议缓冲区基础知识:Java,了解如何使用协议缓冲区生成 pb3 文件的一般信息。

  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 进行评估

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

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