即時更新用例
必須一律在下列情況發出即時更新:
- 使用者從您的系統取消預訂,而該時段會變成 廣告。
- 當使用者透過 Actions Center 預訂 供應時段已無法使用。
- 當你透過 Actions Center 取消預訂時 例如直接由商家決定您需要更新 及供應情形,因為原始時段現已 就能再次使用。
此外,如果您在 供應情形取代 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
有兩種取代方法 供應情形:
-
批次取代 (
InventoryUpdate.BatchServiceAvailability
): 完全取代商家的供應情形資料和 免費 Google Cloud 服務- 注意事項:這項批次呼叫不保證不可部分完成。僅限 更新成功的供應時段。
-
單一取代 (
InventoryUpdate.ReplaceServiceAvailability
): 完全取代單一商家和服務的供應情形。
請使用以下項目 參考資料 詳細資料。
即時更新必須採用與資料相同的可用性結構 會透過動態饋給傳送的圖片請務必使用以下其中一項:
spotsOpen
recurrence
選擇取代呼叫方式
下列指南可協助您判斷哪個取代方法比較合適 適合:
- 單筆預訂會影響多項服務嗎?例如剪髮 和著色 (各自都是不同服務) 的客戶搭配設計師 與該時段樣式清單相關聯的服務,都必須移除。
- 系統會不時向 Google 同步傳送上述所有個人資訊
供應情形自上次更新後有所變動 (不建議)。
- 批次取代
- 注意:我們預計在更新後 5 分鐘內傳送廣告空間 RTU 。因此,建議您至少每 5 分鐘檢查並傳送任何更新。
- 以上皆非嗎?
- 單取代
- 注意:您可以使用多個單一取代呼叫來模擬 但使用單一批次取代呼叫會更有效率 批次取代呼叫
即時更新:Spots 開放格式
請務必在動態饋給、預訂伺服器和 即時更新。
spots_open
動態饋給程式碼片段如下所示:
動態饋給程式碼片段
"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 收到預訂:
動態饋給程式碼片段
"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" } ]
即時更新:重複規則格式
請務必在動態饋給、預訂伺服器和 即時更新。
使用週期的動態饋給看起來會像這樣:
動態饋給程式碼片段
"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" } } ] } ] } ] }
以下是下一個每日動態饋給的預期內容範例。請注意
這是指該商家的完整服務供應情形,
上一個和新的 schedule_exceptions
:
動態饋給程式碼片段
"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 } } ], } ]
提交即時更新的時機
只要供應情形有所變更,就必須持續傳送即時更新。 這項額外功能是完善的供應情形動態饋給, 每天提交一次,才能確保 與 Google 系統之間的關聯