入门 Feed（旧版）

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

创建 Feed

  1. 生成 Feed。大多数商品目录数据都可通过 Feed 传输到 Google。请先创建两种 Feed：

    • 商家 Feed：商家 Feed 对商家进行介绍并提供商家级操作链接。
    • 服务 Feed（可选）：服务 Feed 对服务进行介绍并提供商家向您的平台提供的服务级 action_link。

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

    Feed 字段名称 说明 是否必填？
    商家 merchant_id 商家的唯一标识符 是
    商家 name 商家名称 是
    商家 geo 商家的地址和地理坐标 是
    商家 电话 商家的电话 是
    商家 类别 商家的地点类型 建议填写
    商家 action_link 商家专用深层链接的相关信息 如果提供了服务 Feed，则此参数为可选；否则为必需
    商家 brand_id 用于标识要使用的面向消费者的品牌的字符串 可选
    服务 service_id 商家所提供服务的唯一标识符 是（仅当提供服务 Feed 时）
    服务 merchant_id 指向提供此服务的商家的链接 是（仅当提供服务 Feed 时）
    服务 localized_service_name 所提供服务的名称 是（仅当提供服务 Feed 时）
    服务 localized_description 可供用户查看的服务说明 可选
    服务 action_link 提供与服务相关的深层链接的信息 是（仅当提供服务 Feed 时）
    服务 类型 深层链接的类型（例如 SERVICE_TYPE_DINING_RESERVATION） 是（仅当提供服务 Feed 时）

    首先，请查看示例 Feed

    如果提供多项服务的商家使用单个操作链接，则应在商家 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 地图上的营业地点信息相匹配。