बुकिंग सर्वर तैयार है

आपको बुकिंग सर्वर की ज़रूरत होगी, ताकि Actions Center आपकी ओर से बुकिंग बना सके और उन्हें अपडेट कर सके. इसके लिए, Actions Center को कॉलबैक करने की अनुमति दें. इससे Actions Center को उपयोगकर्ता की ओर से, आपके साथ अपॉइंटमेंट, बुकिंग, और रिज़र्वेशन करने की अनुमति मिलती है.

अपने सैंडबॉक्स और प्रोडक्शन बुकिंग सर्वर से कनेक्शन कॉन्फ़िगर करने का तरीका जानने के लिए, बुकिंग सर्वर के क्रेडेंशियल कॉन्फ़िगर करना लेख पढ़ें.

रीयल-टाइम अपडेट पर जाने से पहले, बुकिंग सर्वर के लिए तैयार किए गए ये टास्क पूरे करें:

सैंडबॉक्स बुकिंग फ़्लो के ज़रिए बुकिंग सर्वर के अनुरोधों को इन्वेंट्री की सटीक और रीयल-टाइम जानकारी भेजने पर, हर टास्क को 'पूरा हुआ' के तौर पर मार्क किया जाता है. साथ ही, यह हरे रंग में बदल जाता है. बुकिंग सर्वर के माइलस्टोन का विश्लेषण, 14 दिनों की अवधि में किया जाता है.

REST API इंटरफ़ेस लागू करना

REST पर आधारित एपीआई इंटरफ़ेस लागू करें. इससे Google, बुकिंग सर्वर को एचटीटीपीएस पर अनुरोध भेज पाता है.

एपीआई इंटरफ़ेस लागू करने के लिए, एक डेवलपमेंट या Sandbox Booking Server सेट अप करें. यह Actions Center के सैंडबॉक्स एनवायरमेंट से कनेक्ट होता है. सैंडबॉक्स सर्वर की पूरी तरह से जांच करने के बाद ही, प्रोडक्शन एनवायरमेंट पर जाएं.

Google के बुकिंग सर्वर से किए गए सभी अनुरोध, बुकिंग सर्वर पेज पर सेट किए गए बुकिंग सर्वर के यूआरएल से जुड़े होते हैं. उदाहरण के लिए, अगर आपका यूआरएल api.example.com/google पर सेट है, तो सभी HealthCheck अनुरोध api.example.com/google/v3/HealthCheck को भेजे जाते हैं.

पक्का करें कि एनवायरमेंट स्विचर के साथ, सैंडबॉक्स और प्रोडक्शन, दोनों एनवायरमेंट के लिए बुकिंग सर्वर का सही एंडपॉइंट कॉन्फ़िगर किया गया हो.

सुरक्षा और पुष्टि

आपके बुकिंग सर्वर से सभी कम्यूनिकेशन, सामान्य पुष्टि करने की सुविधा का इस्तेमाल करके एचटीटीपीएस पर होता है. हमारा सुझाव है कि सर्वर सेट अप करने के लिए, सार्वजनिक तौर पर उपलब्ध एसएसएल या टीएलएस की पुष्टि करने वाले टूल का इस्तेमाल करें. जैसे, Qualys का एसएसएल सर्वर टेस्ट.

Google, आपके बुकिंग सर्वर को जो भी अनुरोध भेजता है उनकी पुष्टि, एचटीटीपीएस बेसिक ऑथेंटिकेशन की मदद से की जाती है. Actions Center के बुकिंग सर्वर कॉन्फ़िगरेशन पेज पर, बुकिंग सर्वर की बुनियादी पुष्टि करने की जानकारी, पासवर्ड, और उपयोगकर्ता नाम डाला जा सकता है. क्रेडेंशियल को हर छह महीने में बदलना ज़रूरी है.

बुकिंग सर्वर बनाना

बुकिंग सर्वर यह तय करता है कि इंटिग्रेशन, आपके सिस्टम से कैसे कम्यूनिकेट करेगा. साथ ही, यह बुकिंग करता है या उन्हें अपडेट करता है. अपने सैंडबॉक्स और प्रोडक्शन बुकिंग सर्वर से कनेक्शन कॉन्फ़िगर करने के लिए, बुकिंग सर्वर के क्रेडेंशियल कॉन्फ़िगर करना लेख पढ़ें.

Reserve with Google से मिले हर अनुरोध के जवाब में, आपके बुकिंग सर्वर को इन्वेंट्री की सटीक और रीयल-टाइम जानकारी देनी होगी. यहां दी गई टेबल में, हर तरीके को लागू करने के तरीके बताए गए हैं. साथ ही, इसमें सेवा प्रोटोकॉल फ़ॉर्मैट के लिंक भी शामिल हैं:

तरीका परिभाषा जवाब एचटीटीपी अनुरोध
BatchAvailabilityLookup पेज लोड

जब कोई व्यक्ति, कारोबारी या कंपनी के लिए टेबल बुक करें पर क्लिक करता है, तो पेज लोड होने पर BatchAvailabilityLookup अनुरोध किया जाता है.

इस पेलोड में कई स्लॉट शामिल हैं. ये स्लॉट, हाल ही में अपलोड किए गए आपके फ़ीड पर आधारित हैं. Reserve with Google इन्हें उपलब्ध मानता है.

 जवाब में, हर स्लॉट के अनुरोध और स्लॉट की मौजूदा उपलब्धता के बारे में जानकारी शामिल होनी चाहिए. इससे बुकिंग के लिए उपलब्ध न होने वाले स्लॉट नहीं दिखते. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup स्लॉट पर क्लिक जब किसी उपयोगकर्ता को बुकिंग के लिए उपलब्ध स्लॉट दिखाए जाते हैं और वह किसी स्लॉट पर क्लिक करता है, तो स्लॉट पर क्लिक करने के लिए BatchAvailabilityLookup अनुरोध किया जाता है. जवाब में, स्लॉट की मौजूदा और असल उपलब्धता के बारे में जानकारी होनी चाहिए. अगर स्लॉट पर क्लिक करने से पहले ही बुकिंग हो चुकी है, तो जवाब में बताएं कि यह स्लॉट उपलब्ध नहीं है. POST /v3/BatchAvailabilityLookup/
CreateBooking जब कोई उपयोगकर्ता, बुकिंग वाले मोडल में चुने गए टाइम स्लॉट को बुक करने की पुष्टि करता है, तब CreateBooking अनुरोध भेजा जाता है.

जवाब में बुकिंग के पूरा होने या पूरा न होने की जानकारी होनी चाहिए.

अगर बुकिंग नहीं हो पाती है, तो आपको बुकिंग न होने की वजह बतानी होगी. उदाहरण के लिए, CreateBooking रिस्पॉन्स को कॉल करने से पहले ही स्लॉट बुक कर लिया गया था.

अगर बुकिंग हो जाती है, तो जवाब में एक यूनीक booking_id शामिल होता है. इसका इस्तेमाल, आने वाले समय में बुकिंग से जुड़े किसी भी अनुरोध या अपडेट के लिए किया जा सकता है.

 POST /v3/CreateBooking/
UpdateBooking Reserve with Google सुविधा का इस्तेमाल करके बुकिंग करने के बाद, उपयोगकर्ता अपनी बुकिंग में बदलाव कर सकता है. जब उपयोगकर्ता अपनी बुकिंग अपडेट करता है या उसे रद्द करता है, तब UpdateBooking अनुरोध भेजा जाता है. CreateBooking रिस्पॉन्स की तरह, UpdateBooking के लिए दिए गए रिस्पॉन्स में भी बुकिंग के पूरा होने की जानकारी होनी चाहिए. इसके अलावा, बुकिंग पूरी न होने की वजह भी बताई जानी चाहिए. POST /v3/UpdateBooking/
HealthCheck Actions Center, आपके बुकिंग सर्वर को नियमित तौर पर कॉल करता है, ताकि यह पुष्टि की जा सके कि आपका इंफ़्रास्ट्रक्चर चालू है और काम कर रहा है.

अपने सर्वर की सेवा देने की स्थिति के बारे में बताने के लिए, एचटीटीपी स्टेटस कोड का इस्तेमाल करें. अगर सर्वर चालू है और ठीक से काम कर रहा है, तो एचटीटीपी स्टेटस कोड 200 दिखाएं.

गड़बड़ी दिखाने या इंटिग्रेशन को कुछ समय के लिए ऑफ़लाइन करने के लिए, सही नॉन-2xx एचटीटीपी स्टेटस कोड दिखाएं.

 GET /v3/HealthCheck/

माइलस्टोन की शर्तें

'बुकिंग सर्वर तैयार है' माइलस्टोन पूरा करने के लिए, आपके इंटिग्रेशन को सैंडबॉक्स और प्रोडक्शन एनवायरमेंट में ये शर्तें पूरी करनी होंगी:

तरीका ज़रूरी है अनुरोधों की संख्या (सैंडबॉक्स) अनुरोधों की ज़रूरी संख्या (प्रोडक्शन) ज़रूरी सफलता दर
BatchAvailabilityLookup पेज लोड 20 20 90%
BatchAvailabilityLookup स्लॉट पर क्लिक 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

सैंडबॉक्स बुकिंग फ़्लो

सैंडबॉक्स बुकिंग फ़्लो देखने के लिए, Actions Center इन्वेंट्री व्यू पर जाएं. इन्वेंट्री व्यू के RwG - E2E कॉलम में, लाइव (सैंडबॉक्स में) लिंक दिखता है. यह लिंक, सैंडबॉक्स में कारोबारियों के लिए बुकिंग फ़्लो का होता है. यह लिंक उन कारोबारियों के लिए होता है जो मिलते-जुलते हैं और जिनके पास आने वाले समय में उपलब्धता है.

बुकिंग फ़्लो में ये कार्रवाइयां शामिल हैं:

  • RwG - E2E लिंक पर क्लिक करने पर, पेज लोड होने पर BatchAvailabilityLookup अनुरोध ट्रिगर होता है. साथ ही, कारोबारी या कंपनी के लिए उपलब्ध बुकिंग स्लॉट की जानकारी दिखती है.

  • बुकिंग के समय पर क्लिक करने से, BatchAvailabilityLookup on slot click request ट्रिगर होता है और बुकिंग का मोडल दिखता है.

  • CreateBookingअनुरोध भेजने के लिए, बुकिंग मोडल का इस्तेमाल करके बुकिंग पूरी करें.

  • सैंडबॉक्स एनवायरमेंट में बुकिंग पूरी करने के बाद, बुकिंग करने के लिए इस्तेमाल किए गए खाते को बुकिंग की जानकारी के साथ पुष्टि करने वाला ईमेल मिलता है.

  • UpdateBooking तरीके को ट्रिगर करने के लिए, ईमेल से बुकिंग में बदलाव करें या उसे रद्द करें.

HealthCheck

पक्का करें कि आपने सैंडबॉक्स और प्रोडक्शन में HealthCheck तरीके को लागू किया हो. इस तरीके से, आपके बुकिंग सर्वर के स्टेटस की जानकारी मिलती है. इससे Google को आपके बुकिंग सर्वर की सेवा देने की स्थिति पर लगातार नज़र रखने में मदद मिलती है.

अनुरोध: कोई नहीं

रिटर्न वैल्यू: कोई नहीं

अपने सर्वर की सेवा देने की स्थिति के बारे में बताने के लिए, एचटीटीपी स्टेटस कोड का इस्तेमाल करें.

अगर सर्वर चालू है और ठीक से काम कर रहा है, तो एचटीटीपी स्टेटस कोड 200 दिखाएं. अगर कोई गड़बड़ी है, तो इनमें से कोई एक एचटीटीपी स्टेटस कोड दिखाएं.