实时更新的使用场景
在以下情况下,必须始终发出实时更新:
- 用户取消您系统上的预订,且空档变为 可用。
- 当用户通过操作中心和 无法再使用。
- 如果您的设备上通过操作中心进行的预订被取消, 例如由商家直接上传您需要更新 因为原始空档现在位于 。
此外,如果您实现 可用性替换 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
如果对 Actions Center 预订进行了更新(例如,取消或
会造成的影响,
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
<ph type="x-smartling-placeholder">有两种类型的替换方法可用于更新 库存状况:
-
批量替换 (
InventoryUpdate.BatchServiceAvailability
): 完全替换一个商家和多个 服务。- 注意:此批量调用不保证原子性。仅限 将返回已成功更新的可用性空档。
-
单次替换 (
InventoryUpdate.ReplaceServiceAvailability
): 完全取代单个商家和服务的可用性。
请使用以下 如需了解详情,请参阅参考文档 。
实时更新必须使用与数据相同的可用性结构 通过 Feed 发送的请求必须使用以下项之一:
spotsOpen
recurrence
选择要调用的替换方法
使用以下指南帮助您确定哪种替换方法更为有效 适合:
- 单次预订会影响多项服务吗?例如,理发 而且配色服务(每项服务都是不同的服务)则由发型师预约, 与该时间空档相关联的造型师服务应予以移除。
- 您的系统会不时地与 Google 同步,
自上次更新后库存状况更改过(不推荐)。
- 批量替换
- 注意:我们预计会在更新后的 5 分钟内发送广告资源 RTU 。因此,您应该至少每 5 分钟检查并发送一次更新。
- 以上解答皆不适用?
- 单次替换
- 注意:您可以使用多个替换调用来模拟 但使用单个替换调用会更高效, 批量替换调用
实时更新:Spots Open 格式
请务必在 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 代码段
"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" } ]<ph type="x-smartling-placeholder">
实时更新:重复规则格式
请务必在 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" } } ] } ] } ] }<ph type="x-smartling-placeholder">
下面的示例展示了下个每日 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 的补充,应 每天提交一次,以确保库存状况同步 您的系统与 Google 的系统之间。