Feed 就绪

Feed 会向 Actions Center 提供您的商品目录数据。此每日安全文件传输协议 (SFTP) 上传会更新所有商家信息、服务和可用性空档数据。Feed 会指定您支持的商家、这些商家的商品目录可用性，以及确保 Google 正确显示您的商品目录所需的任何特殊功能。Feed 会上传到您在设置中提供 SSH 密钥时配置的 SFTP Dropbox。

在迁移到预订服务器之前，您必须完成以下“Feed 就绪”任务：

成功上传 Feed 后，相应任务将被标记为已完成并变为绿色。请查看链接的文档，完成每个特定的里程碑任务。

为了让餐饮预订端到端集成正常运行，您需要每天自动上传商家 Feed、服务 Feed 和空闲时间 Feed。您的自动化 Feed 基础架构必须提供完整的商品目录。

Feed 类型

餐饮预订端到端集成需要以下 Feed 及其上传频率：

动态 说明 频率 示例
商家 描述您的商家。 每 24 小时一次 商家 Feed 示例
服务 描述商家的服务。 每 24 小时一次 服务 Feed 示例
适用范围 描述您的商家所提供服务的可用空档。必须提供至少 30 天的覆盖范围。如需将保修期限延长至 90 天，请通过操作中心联系表单与 Google 支持团队联系。 每 24 小时一次 可用性 Feed 示例

Feed 格式使用 Protocol Buffer 3 语法进行描述，但您可以根据相应的 JSON 格式上传 Feed。如需了解 JSON 格式，请参阅 Feed 示例。我们建议您以 JSON 格式上传 Feed。

命名惯例和元数据

文件名

如果您使用分片，则上传的 Feed 必须具有唯一的名称，用于指定 Feed 类型和数量。Feed 生成的时间戳可满足 Feed 文件命名的唯一性要求。

结构：{feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json

示例：availability_feed_1574117613_001_of_002.json.gz

定义 ID

为商家或需要 ID 的其他属性定义 ID 时，我们强烈建议您使用 UID 或 UUID。您可以提供自己的字母数字解决方案，前提是 ID 在整个平台中保持唯一性。

元数据

创建 Feed 时，generation_timestamp 必须反映从数据库提取数据的时间。在多个 Feed 中重复使用此值可能会导致处理错误。

随机数或不重复的数字必须在各种 Feed 类型中保持唯一，并且不能重复使用。特定分片 Feed 中的所有文件的该值必须一致。

Feed 文件大小

对 Feed 文件进行分片

根据您的商品目录，可能需要将 Feed 分片或拆分为多个文件。在以下情况下，您可能需要对 Feed 进行分片：

  • 压缩后的 gzip Feed 中有一个文件超过 200 MB。
    • 示例：生成的可用性 Feed 为 1 GB。必须将此数据分片到五个或更多个单独的分片中。
  • 合作伙伴广告资源分布在多个系统或区域中，导致难以对广告资源进行对账。
    • 示例：合作伙伴在美国和欧盟拥有库存，这些库存位于不同的系统中。 Feed 可能会生成两个分片。一个用于美国，一个用于欧盟，具有相同的随机数和 generation_timestamp。

如需了解详情，请参阅分片 Feed 文件教程和最佳实践。

一个 Feed 可以包含多个名为分片的文件。如需确定 Feed 的大小，请遵循以下指南：

  • 建议的 Feed 分片：
    • 商家 Feed：1 个分片。
    • 服务 Feed：1 个分片。
    • 可用性 Feed：不到 20 个分片。如果您有业务理由需要超过指定金额的退款，请与支持团队联系，以获取进一步的说明。
  • Feed 文件和分片的大小：
    • 确保分片文件在压缩后小于 200 MB。如有需要，请使用多个分片。
    • 在一个分片中发送的各个记录无需在未来 Feed 中的同一分片中发送。
    • 为实现更好的性能，您应将数据平均分到各个分片，使所有分片文件的大小相近。
    • 如有必要，请使用 gzip 压缩每个 Feed 分片的纯文本 JSON Feed。

压缩 Feed 文件

任何 JSON 或 PB3 文件都可以在上传之前使用 gzip 进行压缩。这可以显著减小每日 Feed 的字节大小。

每个分片文件都必须经过 gzip 压缩并单独上传，例如 gzip*.json。 压缩的 Feed 分片必须以 .json.gz 或 .pb3.gz 结尾。

将 Feed 上传到 SFTP Dropbox

生成商家、服务和预约情况 Feed 后，您可以通过 SFTP Dropbox 将 Feed 上传到沙盒或生产环境。当您在设置中提供 SSH 密钥时，系统会配置 SFTP Dropbox。 您可通过 sftp://partnerupload.google.com 上的端口 19321 访问 Google SFTP 服务器。

Google 会在 Feed 文件上传到 SFTP Dropbox 后立即对其进行审核和验证。如果将 Feed 分片为多个文件，系统会在您上传最后一个文件后对其进行处理。如果您的 Feed 存在错误，系统会向您发送一封包含 Feed 错误代码的电子邮件。 错误会导致系统无法提取已定义的商家、服务或可用性。Feed 通过验证后，最长可能需要 24 小时才能显示在前端。