概览

本部分详细介绍了与 Action Center 集成时需要注意的 3 个主要方面。您在执行端到端集成指南中所述的操作步骤时会用到。

Feed

Feed 是指 JSON 或 pb3 格式的文件，用于将您的商品目录数据传输至“行动中心”。使用 Feed 可一次性提交所有数据，以通过 SFTP 上传来更新商家信息、服务和可用性空档。

Maps Booking API

借助 Maps Booking API，您可在提交 Feed 期间更新“行动中心”系统中的对象，从而及时更新信息。您还可通过该 API 取消使用“通过 Google 预订”端到端集成进行的预订。

实时更新是使用 REST 调用实现的。

注意：实时更新很少适用于入门集成。 对于初始集成，您可以忽略 Maps Booking API。

注意：某些现有的旧版集成使用的是 RPC 调用。 此版本仍在维护中，但不得用于新集成。

预订服务器

为了让端到端集成的 Google 易购中心代表您创建预订，您必须设置预订服务器。

注意：这不适用于入门版集成。

REST API

v3 版本是最新的 API 版本，且支持 REST 接口。应在所有新集成中使用 v3 API。

本部分指定了用于将商品目录数据传输到 Action Center 的 Feed 文件。Feed 中的内容可定义您提供哪些服务、哪些服务可用以及何时可用。

请查看参考文档和示例 accordion 了解如何与我们分享这些 Feed。

商品目录 Feed 的结构由 Google Maps Booking API 进行定义。

以下 Feed 是任何集成都必须提供的：

• 商家 Feed：对您的商家进行介绍的数据。

此外，若要实现端到端集成，您必须提供以下 2 个 Feed。

• 服务 Feed：介绍您的商家所提供的服务。
• 可用性 Feed：列出您的商家所提供服务的可用性空档。

注意：所有 Feed 均必须与 processing_instruction PROCESS_AS_COMPLETE 一同上传。PROCESS_AS_INCREMENTAL 已废弃，无法使用。

这些 Feed 中的部分字段为必填字段，部分字段为选填字段。可从 Feed 中删除任何标记为选填的空值字段。

Feed 格式使用协议缓冲区 3 语法进行描述。您可以选择以 pb3 格式或派生的 JSON 格式将 Feed 文件上传为协议缓冲区数据的二进制文件序列化。我们建议您以 JSON 格式上传 Feed。

我们建议您在上传前使用 gzip 压缩 Feed。

本指南适用于 Action Center 协议缓冲区。有关如何使用协议缓冲区生成 pb3 文件的一般信息，请参阅下面的 Java 示例。