实时更新使用场景
必须始终在以下情况发出实时更新:
- 当用户取消您系统中的预订时,相应槽会变为可用。
- 当用户通过“通过 Google 预订”完成预订且可用性空档不再可用时。
- 当您通过“通过 Google 预订”进行预订时(例如,商家直接取消)。您需要更新预订和空房情况,因为原来的空档已恢复为可预订状态。
此外,如果您实现可用性替换 RTU,则应在以下情况下发出实时更新:
- 商家在您的系统中更改其时间安排(库存状况)后。
- 当用户预订系统中的预订且可用性空档不再可用时。
-
如果您使用的是与
CheckAvailability
的旧版集成,则预订服务器CheckAvailability
调用会返回与实际商品目录不匹配的商品目录。
仅部分 Maps Booking API 调用是必需的。以下几项是必需的:
-
notification.partners.bookings.patch
(BookingNotification.UpdateBooking
)
根据集成的类型,以下配置可能也可用或必不可少:
inventory.partners.availability.replace
(InventoryUpdate.BatchServiceAvailability
) 或inventory.partners.merchants.services.availability.replace
(InventoryUpdate.ReplaceServiceAvailability
)
更新预订 RTU
如果您的系统上的“通过 Google 预订”预订(例如取消或修改)更新,则必须发送 notification.partners.bookings.patch
(BookingNotification.UpdateBooking
)。
可修改字段
status
startTime
duration
partySize
paymentInformation.prepaymentStatus
取消示例
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: { "name": "partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "merchantId": "10001", "serviceId": "1001", "startTime": "2014-10-02T15:01:23.045123456Z", "duration": "3000s", "status": "CANCELED" }
可用性替换 RTU
有两种类型的替换方法可用于更新可用性:
-
批量替换 (
InventoryUpdate.BatchServiceAvailability
):完全替换商家和多项服务的可用性数据。- 注意:此批量调用不保证原子性。系统将仅返回已成功更新的可用性空档。
-
单个替换 (
InventoryUpdate.ReplaceServiceAvailability
):完全替换单个商家和服务的可用性。
如需了解详情,请参阅以下参考文档。
实时更新必须使用与通过 Feed 发送的数据相同的可用性结构。它们必须使用以下格式之一:
spotsOpen
recurrence
选择要调用的替换方法
您可以参考以下指南来确定哪种替换方法更合适:
- 一项预订是否会影响多项服务?例如,发型和着色(每一项都是不同的服务)都是通过造型师预订的,因此应与相应时间段的造型师关联的所有服务。
- 您的系统将不时更新 Google 的数据,方法是发送自上次更新以来的所有可用性变更(不推荐)。
- 批量替换
- 注意:我们希望在您更新后 5 分钟内发送商品目录 RTU。因此,您至少应每 5 分钟检查并发送一次更新。
- 以上都不适用?
- 单个替换
- 注意:您可以使用多个单个替换调用来模拟批量替换调用,但使用单个批量替换调用会更加高效
实时更新:Spot 开放格式
请务必在 Feed、预订服务器和实时更新中使用相同的格式。
spots_open
Feed 代码段如下所示:
Feed 代码段
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 2, "spots_total": 2, "start_sec": 1412263800, # October 02, 2014 15:30:00 "duration_sec": 1800, "availabilityTag": "1000001" } ]
对于 Inventory Update API,当预约下午 3:30 时,系统会替换请求正文的格式:
替换实时更新代码段
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "1", "spotsTotal": "2", "availabilityTag": "1000001" } ] } ] }
下面是一个示例,展示了我们在下午 3:30 预订的下一个每日 Feed 中的活动:
Feed 代码段
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 1, "spots_total": 2, "start_sec": 1412263800, # October 02, 2014 15:30:00 "duration_sec": 1800, "availabilityTag": "1000001" } ]
实时更新:重复格式
请务必在 Feed、预订服务器和实时更新中使用相同的格式。
使用重复周期的 Feed 如下所示:
Feed 代码段
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 1, "spots_total": 1, "start_sec": 1540890000, # October 30, 2018 9:00:00 AM "duration_sec": 1800, "recurrence": { "repeat_every_sec": 1800, "repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM }, "schedule_exception": [ { "time_range": { "begin_sec": 1540902600, # October 30, 2018 12:30:00 PM "end_sec": 1540904400 # October 30, 2018 1:00:00 PM } } ], } ]
对于 Inventory Update API,当下午 3:30 的预约空档时,系统会替换请求正文的格式,如下所示:
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2018-10-30T15:01:23.045123456Z", "endTimeRestrict": "2018-10-30T19:01:23.045123456Z", "availability": [ { "startTime": "2018-10-30T15:30:00.00Z", "duration": "3600s", "spotsOpen": "1", "scheduleException": [ { "timeRange": { "startTime": "2018-10-30T12:30:00.00Z", "endTime": "2018-10-30T13:00:00.00Z" } }, { "timeRange": { "startTime": "2018-10-30T15:30:00.00Z", "endTime": "2018-10-30T16:00:00.00Z" } } ] } ] } ] }
下例说明了下个每日 Feed 的预期变化。请注意,它就是该商家对整个服务的可用性,以及它之前和现在的所有 schedule_exceptions
:
Feed 代码段
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 1, "spots_total": 1, "start_sec": 1540890000, # October 30, 2018 9:00:00 AM "duration_sec": 1800, "recurrence": { "repeat_every_sec": 1800, "repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM }, "schedule_exception": [ { "time_range": { "begin_sec": 1540902600, # October 30, 2018 12:30:00 PM "end_sec": 1540904400 # October 30, 2018 1:00:00 PM } }, { "time_range": { "begin_sec": 1540913400, # October 30, 2018 3:30:00 PM "end_sec": 1540915200 # October 30, 2018 4:00:00 PM } } ], } ]
何时提交实时更新
每当可用性发生变化时,都应持续发送实时更新。 这是对全面可用性 Feed 的补充,您应每天提交一次此类 Feed,以确保您和 Google 系统之间的可用性同步。