सिंक्रोनस बुकिंग, ऐसी बुकिंग होती हैं जिनकी पुष्टि या अस्वीकार की प्रक्रिया रीयल टाइम में होती है.
असाइनोसाइनस बुकिंग, ऐसी बुकिंग होती हैं जिनकी पुष्टि कारोबारी बाद में करता है या जिन्हें वह अस्वीकार करता है.
बुकिंग को उपलब्धता के लेवल पर, सिंक्रोनस या एसिंक्रोनस के तौर पर तय किया जाता है. इसका मतलब यह भी है कि किसी कारोबारी या कंपनी और सेवा के लिए, सिंक्रोनस और एसिंक्रोनस, दोनों तरह के अवेलबिलिटी स्लॉट हो सकते हैं.
सही तरीके से लागू करने के लिए, सबसे पहले यह पता लगाएं कि आपकी इन्वेंट्री किस कैटगरी में आती है:
- सिर्फ़ एक साथ बुकिंग करने की सुविधा चालू करना: सभी व्यापारियों और सेवाओं की पुष्टि तुरंत हो जाती है.
- एक साथ कई बुकिंग करने की सुविधा चालू करना: कुछ या सभी व्यापारियों/कंपनियों और सेवाओं के लिए, व्यापारी/कंपनी की मैन्युअल पुष्टि करना ज़रूरी है.
एसिंक्रोनस बुकिंग की शर्तें
- ऐक्शन सेंटर पर, एक साथ कई बुकिंग करने की सुविधा का इस्तेमाल करके की गई बुकिंग में बदलाव नहीं किया जा सकता.
- कारोबारी या कंपनी, पार्टनर के ऑनलाइन सिस्टम (जैसे, रेस्टोरेंट के लिए होस्ट पैनल) की मदद से, बुकिंग स्वीकार या अस्वीकार कर सके. उपयोगकर्ता की ओर से कारोबारी या कंपनी को कॉल करके यह पता लगाने की अनुमति नहीं है कि कारोबारी या कंपनी ने बुकिंग स्वीकार की है या अस्वीकार की है.
- कारोबारी या कंपनी के पास, बुकिंग के लिए नए समय का प्रस्ताव देने की सुविधा नहीं है. बुकिंग के अनुरोध को, मूल स्थिति में स्वीकार या अस्वीकार किया जाना चाहिए.
सिर्फ़ एक साथ बुकिंग करने की सुविधा चालू करना
स्टैंडर्ड तरीके से लागू करने पर, बुकिंग एक साथ होती हैं. ज़्यादा जानकारी के लिए, कृपया अपॉइंटमेंट के एंड-टू-एंड इंटिग्रेशन के दस्तावेज़ देखें.
एसिंक्रोनस बुकिंग की सुविधा चालू करना
अगर कुछ या सभी व्यापारी/कंपनी, बुकिंग के लिए असिंक्रोनस फ़्लो का इस्तेमाल करते हैं, तो इन बदलावों को करना होगा:
-
पुष्टि करने का तरीका: उपलब्धता स्लॉट के सभी दिखावटों में अब एक
confirmation_mode
फ़ील्ड होता है. इससे यह पता चलता है कि उपलब्धता स्लॉट की बुकिंग की पुष्टि कैसे की जाती है. इनके लिए, उपलब्धता के हर स्लॉट काconfirmation_mode
बताएं:- उपलब्धता फ़ीड में,
confirmation_mode
को उपलब्धता के लेवल पर बताया गया है - Booking सर्वर एपीआई के तरीकों में,
confirmation_mode
को स्लॉट लेवल पर बताया गया है - रीयल-टाइम अपडेट एपीआई के तरीकों में,
confirmation_mode
को उपलब्धता के लेवल पर बताया गया है
- उपलब्धता फ़ीड में,
- बुकिंग की स्थिति: बुकिंग के सभी विज़ुअल में एक
status
फ़ील्ड होता है, जो बुकिंग की स्थिति दिखाता है. एसिंक्रोनस स्टेटस की तीन नई वैल्यू जोड़ी गई हैं:PENDING_CONFIRMATION
,DECLINED_BY_MERCHANT
, औरFAILED
. एक साथ कई बुकिंग करने की सुविधा के तहत, बुकिंग बनाने, अस्वीकार करने, और प्रोसेस न हो पाने की स्थिति को प्रोसेस करते समय, इन नई स्थिति वैल्यू का इस्तेमाल करें. - बुकिंग के अपडेट: बुकिंग के स्टेटस में होने वाले सभी असाइनोक्रोनस अपडेट की सूचना, Booking Notification API के bookings.patch तरीके से दी जानी चाहिए.
नीचे दिए गए डायग्राम में दिखाया गया है कि आम तौर पर, बुकिंग के लिए एक साथ काम न करने वाले इंटरैक्शन में, पुष्टि करने के मोड और बुकिंग की स्थिति का इस्तेमाल कैसे किया जाता है.
- उपलब्धता फ़ीड अपडेट कर दिए गए हैं, ताकि हर उपलब्धता स्लॉट के लिए पुष्टि करने का तरीका तय किया जा सके. फ़ीड में यह जानकारी होना ज़रूरी है, ताकि हम फ़्लो के शुरुआती चरणों में ही उपयोगकर्ता को बुकिंग की असाइनमेंट के बारे में बता सकें.
- जब
BatchAvailabilityLookup
याCheckAvailability
को कॉल किया जाता है, तो हम पुष्टि करने के मोड को पास करते हैं. आम तौर पर, पुष्टि करने का वही मोड दिखाया जाता है जो पास किया गया है. इससे यह पक्का किया जा सकेगा कि उपयोगकर्ता को सही मैसेज दिखाया जाए. - जब
CreateBooking
को कॉल किया जाता है, तो हम पुष्टि करने के मोड को पास करते हैं, ताकि पुष्टि करने के अनुमानित मोड के बारे में पता चल सके. जब बुकिंग का अनुरोध, एक साथ नहीं किया जाता है, तो बुकिंग की स्थितिPENDING_MERCHANT_CONFIRMATION
के साथ दिखती है. - जब व्यापारी/कंपनी किसी बुकिंग के अनुरोध को स्वीकार या अस्वीकार करती है, तो बुकिंग की स्थिति को रीयल-टाइम अपडेट करने वाले बुकिंग सूचना एपीआई के bookings.patch तरीके से अपडेट किया जाता है. अगर आपको उन बुकिंग को अपने-आप अस्वीकार करना है जिनका समय पर जवाब नहीं दिया गया है, तो रीयल-टाइम अपडेट के उसी तरीके का इस्तेमाल करें.
उपलब्धता फ़ीड
उपलब्धता फ़ीड में, बताएं कि हर स्लॉट सिंक्रोनस है या
एसिंक्रोनस. ऐसा करने के लिए, नया confirmation_mode
फ़ील्ड सेट करें.
// Mode by which bookings for an availability slot are confirmed. enum ConfirmationMode { // The confirmation mode was not specified. // Synchronous confirmation will be assumed. CONFIRMATION_MODE_UNSPECIFIED = 0; // Bookings for this availability will be confirmed synchronously. CONFIRMATION_MODE_SYNCHRONOUS = 1; // Bookings for this availability will be confirmed asynchronously. CONFIRMATION_MODE_ASYNCHRONOUS = 2; }
अगर कोई मोड तय नहीं किया गया है, तो पुष्टि करने का मोड सिंक्रोनस माना जाता है. हालांकि, हमारा सुझाव है कि आप साफ़ तौर पर कोई मोड तय करें, ताकि गलती से किसी चीज़ को छोड़ने से जुड़ी कोई गड़बड़ी न हो.
Async
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
सिंक करें
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] }
एक साथ काम नहीं करने वाली प्रोसेस और सिंक
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, { "merchant_id": "10002", "service_id": "1000", "spots_open": 4, "spots_total": 4, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 2 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
बुकिंग सर्वर
BatchAvailabilityLookup या CheckAvailability
BatchAvailabilityLookupResponse
(बल्गेरियन लेव) या
CheckAvailabilityResponse
(कनाडा डॉलर) के लिए, वही confirmation_mode
दिखाएं जो खरीदारी के लिए उपलब्धता वाले फ़ीड में दिया गया है और BatchAvailabilityLookupRequest
या
CheckAvailabilityRequest
के ज़रिए भेजा गया है.
BAL-Async
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "available": true } ] }
BAL-Sync
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "available": true } ] }
CA-Async
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CA-Sync
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CreateBooking
नीचे दिए गए विकल्पों का इस्तेमाल करके, बुकिंग की सही स्थिति दिखाना न भूलें:
// Status of a booking. // // Updating booking status does not change the status of the associated payment. // Prepayment status updates should be done using the PrepaymentStatus enum. enum BookingStatus { // Not specified. BOOKING_STATUS_UNSPECIFIED = 0; // Booking has been confirmed CONFIRMED = 1; // Booking is awaiting confirmation by the merchant before it can transition // into CONFIRMED status. Only applicable to non-payments Dining or // Beauty verticals. PENDING_MERCHANT_CONFIRMATION = 2; // Booking has been canceled on behalf of the user. // The merchant can still trigger a manual refund. CANCELED = 3; // User did not show for the appointment NO_SHOW = 4; // User did not show for the appointment in violation of the cancellation // policy. NO_SHOW_PENALIZED = 5; // Booking could not be completed by the async backend due to a failure. FAILED = 6; // Booking was asynchronously declined by the merchant. Only applicable to // non-payments Dining or Beauty verticals. DECLINED_BY_MERCHANT = 7; }
CreateBookingResponse
में,
CreateBookingRequest में दिए गए बुकिंग के एग्रीगेट किए गए स्लॉट के लिए, मौजूदा confirmation_mode
दिखाएं. इसके अलावा, जब बुकिंग असाइन सिंक नहीं होती है, तो
status
को PENDING_MERCHANT_CONFIRMATION
पर सेट करें. कृपया पक्का करें कि confirmation_mode
, उपयोगकर्ता और Reserve with Google के लिए एक जैसा हो, ताकि उपयोगकर्ता को भ्रम न हो.
Async
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "PENDING_MERCHANT_CONFIRMATION" } }
सिंक करें
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "CONFIRMED" } }
UpdateBooking
असाइन किए गए टास्क के साथ-साथ, किसी मौजूदा बुकिंग में उपयोगकर्ता के बदलाव करने की सुविधा, असाइन किए गए टास्क की शुरुआती रिलीज़ में उपलब्ध नहीं है. इसके बजाय, उपयोगकर्ता को बुकिंग रद्द करनी चाहिए और एक नई बुकिंग करनी चाहिए.
रीयल-टाइम अपडेट
उपलब्धता के बारे में रीयल-टाइम अपडेट पाने के लिए, confirmation_mode
की वैल्यू सबमिट करें. यह इन तरीकों पर लागू होता है:
इन्वेंट्री RTU (ReplaceServiceAvailability या BatchReplaceServiceAvailability)
availability.replace
(बैच) तरीके या
services.availability.replace
तरीके का इस्तेमाल करके,
Availability
में confirmation_mode
को CONFIRMATION_MODE_ASYNCHRONOUS
पर सेट करें
Async
{ "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": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] } ] }
सिंक करें
{ "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": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
एक साथ काम नहीं करने वाली प्रोसेस और सिंक
{ "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": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, { "startTime": "2014-10-03T11:00:00.00Z", "duration": "5400s", "spotsOpen": "1", "spotsTotal": "1", "availabilityTag": "1000002", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
Booking Notification API
बुकिंग की स्थिति में असाइनोक्रोनस अपडेट करने के लिए, बुकिंग सूचना एपीआई bookings.patch का इस्तेमाल करें.
स्थिति अपडेट करते समय, updateMask
में status
फ़ील्ड का नाम शामिल करना न भूलें.
स्थिति | ब्यौरा |
---|---|
पुष्टि हो गई | कारोबारी या कंपनी ने बुकिंग की पुष्टि कर दी हो |
FAILED | पार्टनर, कारोबारी या कंपनी से बुकिंग की पुष्टि नहीं कर सका या उसे अस्वीकार नहीं कर सका |
DECLINED_BY_MERCHANT | कारोबारी या कंपनी ने बुकिंग अस्वीकार कर दी है |
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"DECLINED_BY_MERCHANT"}
अगर बुकिंग नहीं हो पाती है, तो बुकिंग की स्थिति को FAILED
पर सेट करें और
booking_failure की जानकारी दें. अगर स्थिति को किसी और वैल्यू पर सेट किया गया है, तो
booking_failure
को अनदेखा कर दिया जाता है.
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status&booking_failure.cause="SLOT_UNAVAILABLE" Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"FAILED"}
ईमेल सूचनाएं
एक साथ कई बुकिंग करने पर, उपयोगकर्ताओं को बुकिंग की स्थिति से जुड़े पांच संभावित ईमेल भेजे जाते हैं.
PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED