预订服务器已准备就绪

您需要预订服务器，以便操作中心能够进行回调，代表您创建和更新预订。这样，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 基本身份验证进行身份验证。您可以在 Actions Center 的“预订服务器”配置页面中输入预订服务器的基本身份验证信息、密码和用户名。凭据必须每 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 操作中心会定期调用您的预订服务器，以确认您的基础架构处于有效且运行状态。

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

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

 GET /v3/HealthCheck/

沙盒预订流程

如需查看沙盒预订流程，请前往 Action Center 的资源目录视图。“资源”视图的 RwG - E2E 列会针对匹配且未来有空闲时间的沙盒商家显示指向沙盒预订流程的有效（在沙盒中）链接。

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

  • 当您点击 RwG - E2E 链接时，系统会在网页加载时触发 BatchAvailabilityLookup 请求，并显示商家的已知可预订情况。
  • 当您点击预订时间时，系统会触发 BatchAvailabilityLookup slot click 请求并显示预订模态框。
  • 通过预订模态框完成预订，以发送 CreateBooking 请求。
  • 在沙盒环境中完成预订后，用于创建预订的账号会收到一封确认电子邮件，其中包含预订详情。
  • 如需触发 UpdateBooking 方法，请通过电子邮件更改或取消预订。

HealthCheck

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

请求：无

返回值：无

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

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