本部分详细介绍了与 Action Center 集成时需要注意的 3 个主要方面。您在执行端到端集成指南中所述的操作步骤时会用到。
Feed
Feed 是指 JSON
或 pb3
格式的文件,用于将您的商品目录数据传输至“行动中心”。使用 Feed 可一次性提交所有数据,以通过 SFTP 上传来更新商家信息、服务和可用性空档。
Maps Booking API
借助 Maps Booking API,您可在提交 Feed 期间更新“行动中心”系统中的对象,从而及时更新信息。您还可通过该 API 取消使用“通过 Google 预订”端到端集成进行的预订。
实时更新是使用 REST 调用实现的。
预订服务器
为了让端到端集成的 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 格式使用协议缓冲区 3 语法进行描述。您可以选择以 pb3 格式或派生的 JSON 格式将 Feed 文件上传为协议缓冲区数据的二进制文件序列化。我们建议您以 JSON 格式上传 Feed。
我们建议您在上传前使用 gzip 压缩 Feed。
本指南适用于 Action Center 协议缓冲区。有关如何使用协议缓冲区生成 pb3 文件的一般信息,请参阅下面的 Java 示例。