概览

本部分详细介绍了与 Actions Center 集成的 3 个主要部分。您将在端到端指南中所述的步骤中使用每个映像。

Feed

Feed 是 JSON 或 pb3 格式的文件，用于将您的商品目录数据传输到 Actions Center。这样，您就可以一次性提交所有数据，从而使用 SFTP 上传来更新商家、服务和可用性空档。

Maps Booking API

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

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

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

注意：某些现有的旧版集成正在使用 RPC 调用。 此 ID 仍会保留，但不得用于新的集成。

预订服务器

为了让 Actions Center 端到端集成能够代表您创建预订，您必须设置预订服务器。

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

REST API

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

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

请参阅参考文献和示例手风琴，了解如何与我们共享这些 Feed。

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

以下 Feed 在任何集成中都必须提供：

• 商家 Feed：包含对商家进行说明的数据。

此外，必须提供以下 2 个 Feed，才能实现端到端集成。

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

注意：所有 Feed 都必须使用 process_instruction PROCESS_AS_COMPLETE 上传。PROCESS_AS_INCREMENTAL 已被弃用，无法使用。

这些 Feed 中的部分字段为必填字段，部分字段为选填字段。任何标记为选填的字段都可以从 Feed 中删除（当为空时）。

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

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

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