由于商家的新预订、取消情况和时间安排变化,您系统中的商品目录会发生变化。实时更新 (RTU) API 是一种机制,旨在将这些变化以及对现有预订所做的更改通知 Google。
在以下情况下,必须使用 RTU:
- 当用户在您的系统中取消预订时,相应空档会变为可预订状态。
- 用户通过 Action Center 预订了某个空档,但该空档不再可预订。
- 通过 Actions Center 完成的预订由您这一方取消。 例如,商家直接取消了预订。您需要更新预订信息及可用性,因为原来的空档已恢复为可预订状态。
在进入沙盒审核之前,请完成以下 RTU 里程碑任务:
如果某个任务在 14 天内最后 20 个请求均未出现错误,则该任务会被标记为已完成并变为绿色。继续发送成功的请求,以确保里程碑保持绿色。
API RTU 和 Feed
API RTU 会将商品目录可用性和预订的实时增量变化通知 Google。除了 RTU 之外,每天还应发送完整的“商品目录数据”Feed。这样可确保 Google 尽可能准确且及时地了解您系统中的可用性信息。完整的 Feed 可作为您系统中商品目录可用性的最新状态的快照。
如需了解详情,请参阅以下资源:
访问 API
您的 Google Cloud 项目就是您访问 Actions Center 的 Maps Booking API 的方式,您可以通过该 API 提交 RTU。您必须在 Google 开发者控制台中使用 Google 账号,并在您的初始配置计划的“设置”里程碑中提供您的 Cloud 项目编号。如需详细了解如何启用 Cloud API,请参阅启用 Cloud API。
使用 RESTful 调用或者下载客户端库
我们建议您使用 JSON 载荷直接对 Maps Booking API 进行 RESTful 调用。如需了解详情,请参阅 REST API 文档。
您还可以通过客户端库连接到 API。
.语言 | 下载链接 |
---|---|
Java | Java 客户端库。如需了解详情,请参阅 Java 客户端说明 |
您还可下载其他支持库,以处理对 Google API 调用的授权及其他方面。如需了解详情,请参阅代码示例。
提取发现文档
对于部分客户端库(例如 Ruby),有必要提取 API 发现文档,该文档中介绍了相关方法及参数。
如需获取 Discovery 文档,请使用以下命令:
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
如需详细了解如何使用来自 Ruby 的 API,请参阅 Ruby API 客户端和 Ruby 身份验证库。
对 API 进行已获授权的调用
调用 API 时,请参阅为进行委托的 API 调用做准备,通过私钥及以下 OAuth 范围向您的服务账号授权:
https://www.googleapis.com/auth/mapsbooking
沙盒环境和生产环境中的端点
您可通过 API 对沙盒环境和生产环境进行调用。请务必在 Google Cloud 项目中一并启用这两个 API。这两个 API 的范围相同,但端点不同。
生产端点:https://mapsbooking.googleapis.com/
沙盒端点:https://partnerdev-mapsbooking.googleapis.com/
以下是有关如何切换端点的 Java 示例:
// This block of code is for OAuth and is the same for prod and sandbox.
GoogleCredential
.fromStream(new FileInputStream(...))
.createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))
// This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
new GoogleMapsBookingAPI.Builder(...)
.setApplicationName(...)
.setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
.build()