最佳实践

以下最佳实践适用于 Actions Center 预留等位名单集成，可用于避免易用性和性能问题。数据质量较低可能会导致商品目录遭到移除。

Feed

  • 如果服务没有固定时长，请将可用性 Feed 中的 duration_sec 设置为以下其中一项：
    • 以合理的方式执行服务所需的秒数。

    • 完成服务所需的平均秒数。

  • 在商家的 Feed 中输入特定的 Category 字段。例如，餐馆可以提交特定的类型，如法式或日式。如需了解详情，请参阅地点类型，了解可能的类别值。

  • 在商家 Feed 的 Terms 字段中设置商家专用服务条款，以便在预订按钮下方显示以下备注：

    继续操作即表示您同意 <merchant> 的服务条款。
    在本例中，“服务条款”是一个链接，点击该链接可查看“条款”文本字段中设置的文本。

  • 使用 gzip 压缩 Feed

预订服务器

如需优化 Maps Booking API 的集成，请执行以下操作：

  • 始终使用世界协调时间 (UTC) 格式的 UNIX 时间戳。
  • 调用 CreateBooking API 中的新预订时，生成唯一的预订 ID。

实时更新

为确保在预订过程中提供最佳用户体验，请执行以下操作：

  • 对于标准实现，请使用 BookingNotifications API 更改预约的开始时间、时长和预订状态，例如取消或未出席。
  • 如果您这边对 Actions Center 预订有任何更改，请始终使用 BookingNotification API 从系统实时发送实时预订更新，以免 Actions Center 端的数据过时。例如，您可以在操作中心内取消、重新安排或更新预订。
  • 对于来自 UpdateBookingRequest 的每次预订更新，请确保 UpdateBookingResponse 值包含预订 ID，并且所有更新后的字段都必须反映新值。
  • 如果实现了 Inventory RTU
    • 每次调用 API 时，只能批量更新 100-1,000 个槽。
    • 使用 *Restrict（例如 startTimeRestrict）字段可缩小修改目标范围、缩减载荷大小并避免重新发送过多未更改的数据。
    • 如果拆分了多个线程，请实现指数退避算法以防止限制错误。如果未正确实现指数退避算法，则可能会收到 RESOURCE_EXHAUSTED 配额错误。您可以重试指数退避算法来处理它们，但如果您发现服务器在运行 ReplaceServiceAvailability 时经常达到配额，请将服务器配置为批量替换可用性。此解决方案可以防止出现配额错误，因为它可以减少您的服务必须进行的 API 调用次数。
  • 将 API 调用响应时间限制设置为不超过 1 秒。确保您的服务器每秒可处理五次查询 (QPS)，且至少在 95% 的时间内都能实现亚秒级延迟。