预订服务器已准备就绪

您需要一个预订服务器，以便 Actions Center 代表您进行回调来创建和更新预订。这样，Actions Center 就能代表用户与您进行预约和预订。

如需了解如何配置与您的沙盒环境和生产环境中预订 服务器的连接，请参阅 配置预订服务器凭据。

在转到实时更新之前，请完成以下“预订服务器准备就绪”任务：

当您通过沙盒预订流程向预订服务器请求发送准确的实时库存详情时，每个任务都会标记为已完成并变为绿色。 系统会在 14 天内分析预订服务器里程碑。

实现 REST API 接口

实现基于 REST的 API 接口。这样，Google 就能通过 HTTPS 发送预订服务器请求。

如需实现 API 接口，请设置一个开发或沙盒预订服务器，该服务器会连接到 Actions Center 沙盒环境。只有在对沙盒服务器进行全面测试后，才能将其移至生产环境。

Google 的所有预订服务器请求都与 预订服务器页面上设置的 预订服务器网址相关。例如，如果您的网址设置为 api.example.com/google，则所有 HealthCheck 请求都会发送到 api.example.com/google/v3/HealthCheck。

请确保使用环境切换器为沙盒环境和生产环境配置正确的预订服务器端点。

安全和身份验证

与您的预订服务器之间的所有通信均通过 HTTPS 使用基本身份验证进行。建议您在设置服务器时使用公开提供的 SSL 或 TLS 验证工具，例如 Qualys 的 SSL 服务器测试。

Google 向您的预订服务器发出的所有请求都将使用 HTTPS 基本身份验证进行身份验证。您可以在预订服务器配置页面上输入预订服务器的基本 身份验证信息、密码和用户名。凭据必须每 6 个月更改一次。

构建预订服务器

预订服务器决定了集成如何与您的系统通信，以及如何进行或更新预订。如需配置与您的沙盒环境和 生产环境中预订服务器的连接，请参阅 配置预订服务器凭据。

您的预订服务器对“通过 Google 预订”的请求做出的每项响应都应包含准确的实时库存详情。下表所示为每种实现的方法，且包含指向服务协议格式的链接：

方法 定义 响应 HTTP 请求
BatchAvailabilityLookup 网页加载

当用户点击您商家的预订餐桌 时，系统会在网页加载时调用 BatchAvailabilityLookup 请求。

有效负载包含许多插槽，这些插槽基于您最新上传的 Feed 上传，且“通过 Google 预订”认为这些插槽可用。

 响应必须包含每个插槽请求以及插槽的当前 可用性。这样可以防止显示任何不可用的插槽 。 POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup 插槽点击 当用户看到可供预订的插槽并点击某个 插槽时，系统会针对插槽 点击调用 BatchAvailabilityLookup 请求。 响应必须表示插槽的当前实际可用性。如果在点击插槽之前插槽已预订完，则返回插槽不可用的响应。 POST /v3/BatchAvailabilityLookup/
CreateBooking 当用户确认要在 预订模态框中预订所选时间段时，系统会发送 CreateBooking 请求。

响应必须表示预订成功或失败。 预订。

如果预订失败，您需要返回 失败的具体原因。例如，在调用 CreateBooking 响应之前，插槽已预订完。

如果成功创建预订，响应将包含唯一的 booking_id，以便在任何未来的请求或 更新中引用该预订。

 POST /v3/CreateBooking/
UpdateBooking 通过“通过 Google 预订”进行预订后，用户可以选择 修改预订。当用户更新或取消预订时，系统会发送 UpdateBooking 请求。 与 CreateBooking 响应类似，您对 UpdateBooking 的响应必须表示预订成功，或 返回失败的具体原因。 POST /v3/UpdateBooking/
HealthCheck Actions Center 会定期调用您的预订服务器，以 确认您的基础架构处于活跃状态且正常运行。

使用 HTTP 状态代码来指明您的服务器的服务状态。 如果服务器处于活跃状态且正常运行 ，则返回 HTTP 状态代码 200。

如需指明错误或暂时将您的集成下线， 请返回相应的非 2xx HTTP 状态代码。

 GET /v3/HealthCheck/

里程碑条件

如需完成“预订服务器准备就绪”里程碑，您的集成必须在沙盒环境和生产环境中满足以下条件：

方法 所需请求数（沙盒） 所需请求数（生产环境） 所需成功率
BatchAvailabilityLookup 网页加载 20 20 90%
BatchAvailabilityLookup 插槽点击 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

沙盒预订流程

如需查看沙盒预订流程，请前往 Actions Center 库存视图。对于已匹配且未来有空位的沙盒商家，库存视图的 RwG - E2E 列会显示指向 沙盒预订流程的正式（在沙盒中） 链接。

以下是预订流程中的操作：

  • 当您点击 RwG - E2E 链接时，系统会在网页加载时触发 BatchAvailabilityLookup 请求，并显示商家的已知可用性。

  • 当您点击预订时间时，系统会在点击插槽时触发 BatchAvailabilityLookup 请求，并显示预订模态框。

  • 使用预订模态框完成预订，以发送 CreateBooking 请求。

  • 在沙盒环境中完成预订后，用于创建预订的账号会收到一封确认电子邮件，其中包含预订详情。

  • 如需触发 UpdateBooking 方法，请通过电子邮件更改或取消预订。

HealthCheck

请务必在沙盒环境和生产环境中实现 HealthCheck 方法。此方法会返回您的预订服务器的运行状况。它使 Google 能够持续监控您的预订服务器的服务状态。

请求：无

返回值：无

使用 HTTP 状态代码来指明您的服务器的服务状态。

如果服务器处于活跃状态且正常运行，则返回 HTTP 状态代码 200， 如果出现错误，则返回相应的 HTTP 状态代码。