กรณีการใช้งานสําหรับการอัปเดตแบบเรียลไทม์
การอัปเดตแบบเรียลไทม์จะต้องออกในสถานการณ์ต่อไปนี้เสมอ
- เมื่อผู้ใช้ยกเลิกการจองในระบบและสล็อตจะพร้อมใช้งาน
- เมื่อผู้ใช้จองผ่าน "จองกับ 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
คุณอัปเดตเวลาว่างได้ 2 ประเภท ดังนี้
-
การเปลี่ยนเป็นกลุ่ม (
InventoryUpdate.BatchServiceAvailability
): แทนที่ข้อมูลความพร้อมจําหน่ายสินค้าสําหรับผู้ขายและบริการหลายรายการแทน- หมายเหตุ: การเรียกแบบกลุ่มนี้ไม่รับประกันประสิทธิภาพ ระบบจะแสดงเฉพาะช่วงเวลาว่างที่ได้รับการอัปเดตเรียบร้อยแล้ว
-
แทนที่รายการเดียว (
InventoryUpdate.ReplaceServiceAvailability
): แทนที่ความพร้อมจําหน่ายสินค้าของผู้ขายและบริการรายการเดียวโดยสมบูรณ์
โปรดดูรายละเอียดเพิ่มเติมในข้อมูลอ้างอิงต่อไปนี้
การอัปเดตแบบเรียลไทม์ต้องใช้โครงสร้างความพร้อมเดียวกันกับข้อมูลที่ส่งผ่านฟีด โดยลูกค้าจะต้องใช้วิธีใดวิธีหนึ่งต่อไปนี้
spotsOpen
recurrence
การเลือกวิธีแทนที่เพื่อโทรหา
ใช้คําแนะนําต่อไปนี้เพื่อช่วยคุณพิจารณาว่าวิธีการแทนที่ใดเหมาะสมกว่า
- บริการหลายรายการได้รับผลกระทบจากการจองเดียวไหม เช่น ตัดผมและแต่งสีผม (แต่ละแบบเป็นบริการเฉพาะ) ที่มีการจองสไตลิสต์ จึงควรนําบริการทั้งหมดที่เชื่อมโยงกับสไตลิสต์ออกสําหรับช่วงเวลานั้น
- ระบบของคุณจะซิงค์กับ Google เป็นครั้งคราวโดยการส่งการเปลี่ยนแปลงความพร้อมใช้งานทั้งหมดตั้งแต่การอัปเดตครั้งล่าสุด (ไม่แนะนํา)
- การเปลี่ยนเป็นกลุ่ม
- หมายเหตุ: เราคาดหวังว่าจะส่ง RTU ของพื้นที่โฆษณาภายใน 5 นาทีหลังจากการอัปเดตเกิดขึ้นในฝั่งของคุณ คุณควรตรวจสอบและส่งข้อมูลอัปเดตอย่างน้อยทุก 5 นาที
- ไม่ตรงกับข้อใดเลย
- แทนที่ครั้งเดียว
- หมายเหตุ: คุณสามารถใช้การเรียกแทนที่แบบกลุ่มเดียวเพื่อจําลองการเรียกใช้การแทนที่แบบกลุ่ม แต่จะมีประสิทธิภาพมากขึ้นเมื่อใช้การเรียกแทนที่แบบกลุ่มเดียว
การอัปเดตแบบเรียลไทม์: รูปแบบแบบเปิดของ Spot
คุณต้องใช้รูปแบบเดียวกันในฟีด เซิร์ฟเวอร์การจอง และการอัปเดตแบบเรียลไทม์
ข้อมูลโค้ดฟีดของ 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" } ]
สําหรับพื้นที่โฆษณาอัปเดต API รูปแบบคําขอแทนที่สําหรับเมื่อมีการจองช่วงเวลา 15: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" } ] } ] }
ต่อไปนี้คือตัวอย่างสิ่งที่เราจะคาดหวังในฟีดรายวันถัดไป หากมีการจองช่องใหม่เวลา 15: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 } } ], } ]
สําหรับพื้นที่โฆษณาอัปเดต API รูปแบบคําขอแทนที่สําหรับเวลาที่จองช่วงเวลา 15: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