खास जानकारी

रिज़र्वेशन कैंपेन की वेटलिस्ट प्रोग्राम में हिस्सा लेने वाले पार्टनर को, शुरू करने से पहले खाते का सेट अप पूरा करना होगा. हालांकि, वेटलिस्ट की सुविधा का इस्तेमाल करने के लिए, सामान्य गाइड में दिए गए कुछ चरण ज़रूरी नहीं हैं. इस पेज पर दिए गए दिशा-निर्देशों में बताया गया है कि वे पार्टनर जो Reserve with Google पर वेटलिस्ट की सुविधा इस्तेमाल करने में दिलचस्पी रखते हैं उनके लिए क्या करना होगा. हमारा सुझाव है कि आप इंटिग्रेशन के चरणों को पूरा करने से पहले, यह खास जानकारी पढ़ें.

लॉन्च करने की प्रोसेस

पहले डायग्राम में, उन व्यापारियों/कंपनियों/कारोबारियों को लॉन्च करने की प्रोसेस के बारे में बताया गया है जिन्होंने वेटलिस्ट की सुविधा चालू की है और उन्हें ऐक्शन सेंटर पर लॉन्च किया है.

कुल मिलाकर, आपके (पार्टनर) और Google के बीच डेटा फ़्लो को दूसरी इमेज में कैप्चर किया गया है:

बुकिंग की सुविधा देने वाले सभी पार्टनर के लिए दिशा-निर्देश

बुकिंग वेटलिस्ट की सुविधा लागू करते समय इन बातों का ध्यान रखें:

• बुकिंग वाली हर वेटलिस्ट वाले व्यापारी/कंपनी के लिए, सेवा की जानकारी में waitlist_rules की जानकारी भरी जानी चाहिए.
  • आपको वेटलिस्ट और बुकिंग, दोनों के लिए एक ही सेवा का इस्तेमाल करना होगा. दूसरे शब्दों में, अगर आपका रेस्टोरेंट बुकिंग करने की अनुमति भी देता है, तो बुकिंग के लिए सेवा में बस वेटलिस्ट से जुड़ा मेटाडेटा जोड़ें.
• इन मामलों में वेटलिस्ट लागू करने के लिए, मैसेज (एसएमएस) अपडेट भेजना ज़रूरी है:
  • उपयोगकर्ता वेटलिस्ट में शामिल हो गया है. इसलिए, इसकी पुष्टि करें.
  • उपयोगकर्ता को यह सूचना देने के लिए कि उनकी टेबल तैयार है.
  • उपयोगकर्ता को यह सूचना देने के लिए कि उसकी वेटलिस्ट में शामिल होने का अनुरोध रद्द कर दिया गया है.
• एसएमएस में उस पेज का लिंक होना चाहिए जहां लोग वेटलिस्ट में अपनी स्थिति देख सकें.
• सिर्फ़ वेटलिस्ट वाले व्यापारियों/कंपनियों/कारोबारियों के लिए, ऐक्शन सेंटर को उपलब्धता फ़ीड देने की ज़रूरत नहीं है.
• आपके बुकिंग सर्वर को वेटलिस्ट में शामिल वे सभी चरण लागू करने होंगे जो बुकिंग सर्वर लागू करना सेक्शन में दिए गए हैं. बुकिंग और वेटलिस्ट, दोनों की सुविधा देने वाले पार्टनर अपने मौजूदा बुकिंग सर्वर पर, नए तरीके जोड़ सकते हैं.
• ऐक्शन सेंटर, बुकिंग सर्वर में वेटलिस्ट वाले तरीकों के लिए, टेस्ट केस का एक सेट चलाता है.

स्टेटस फ़्लोचार्ट

इस चार्ट में उन स्थितियों के बारे में बताया गया है जिन्हें GetWaitlistEntry कॉल का जवाब देते समय WaitlistEntry.waitlist_entry_state में रिपोर्ट किया जाना चाहिए. चार्ट से यह भी पता चलता है कि WaitlistEntry.waitlist_entry_state_times.*_time_seconds फ़ील्ड को कब रिकॉर्ड और पॉप्युलेट करना है. साथ ही, यह भी बताया जाता है कि उपयोगकर्ता को कब मैसेज (एसएमएस) भेजना है, ताकि उन्हें पता चल सके कि उन्होंने नई स्थिति सेट कर दी है.

सामान्य एज केस

बुकिंग वेटलिस्ट इंटिग्रेशन के दौरान आने वाले सामान्य मामले और उनके पसंदीदा समाधान, यहां दिए गए हैं.

• अगर सभी पार्टी के कुछ साइज़, वेटलिस्ट में शामिल होने की नई सुविधा स्वीकार नहीं कर रहे हैं, तो इन लोगों की वेटलिस्ट में शामिल होने का इंतज़ार नहीं किया गया है. ऐसे में, BatchGetWaitEstimates के जवाब में, सभी पार्टी साइज़ के लिए WaitEstimates वापस आएं. साथ ही, लोगों को इन लोगों की वेटलिस्ट में शामिल होने की अनुमति भी दी जाएगी. 0 parties_ahead_count और/या 0 start_seconds वाले estimated_seat_time_range के साथ और party_size के लिए 0 end_seconds देकर, बिना इंतज़ार किए WaitLength वापस करें
• अगर एक या एक से ज़्यादा पार्टी साइज़, वेटलिस्ट में नए लोगों को शामिल नहीं कर रहे हैं, तो इंतज़ार का समय काफ़ी ज़्यादा हो गया है. ऐसे में, BatchGetWaitEstimates जवाब में उन पार्टी साइज़ के लिए WaitEstimates को हटा देना चाहिए.

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

सिर्फ़ बुकिंग के लिए वेटलिस्ट में शामिल पार्टनर के लिए दिशा-निर्देश

अगर बुकिंग सर्वर का इस्तेमाल सिर्फ़ वेटलिस्ट के लिए किया जाता है, तो इन बातों का ध्यान रखें:

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

उन पार्टनर के लिए दिशा-निर्देश जिनके व्यापारियों/कंपनियों को वेटलिस्ट में शामिल होने की सुविधा को मैन्युअल तरीके से स्वीकार/अस्वीकार करना होगा

अगर आपके व्यापारियों/कंपनियों/कारोबारियों को Google की ओर से वेटलिस्ट में जोड़े गए नए अनुरोधों को मैन्युअल तरीके से स्वीकार या अस्वीकार करना है, तो आपको कुछ और चरण पूरे करने होंगे:

• पार्टी के साइज़ के लिए wait_estimate में, waitlist_confirmation_mode को WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS पर सेट करें. इसके लिए, मैन्युअल पुष्टि करना ज़रूरी है. इसे BatchGetWaitEstimateResponse और GetWaitlistEntryResponse में सेट किया जाना चाहिए.
• वेटलिस्ट में शामिल ऐसी एंट्री जिनके लिए उपयोगकर्ता ने अनुरोध किया है, लेकिन उन्हें अब तक स्वीकार नहीं किया गया है, उनका स्टेटस PENDING_MERCHANT_CONFIRMATION होना चाहिए.

रिज़र्वेशन कैंपेन से जुड़ी वेटलिस्ट की जांच के मामले

Google, इस्तेमाल के इन उदाहरणों की जांच करता है. इससे यह पक्का किया जाता है कि बुकिंग सर्वर लागू करने में, वेटलिस्ट के तरीके काम करते हैं या नहीं. Google, इंतज़ार के समय की जांच भी करता है और उस पर नज़र भी रखता है. लॉन्च से पहले ये सभी टेस्ट पास होने ज़रूरी हैं.

इंतज़ार का अनुमान वापस पाने की प्रक्रिया

• BatchGetWaitEstimatesRequest में अनुरोध किए गए हर पार्टी साइज़ के लिए, इंतज़ार का अनुमान दिखाया जाता है.
• जिन पार्टी के साइज़ के लिए व्यापारी/कंपनी/कारोबारी के पास, वेटलिस्ट में शामिल किए गए नए लोगों को स्वीकार या अस्वीकार करने का विकल्प है उनके लिए, वेटलिस्ट_पुष्टि करने के मोड को WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS पर सेट करें.

वेटलिस्ट में शामिल होने के लिए बनाया गया ईमेल

• CreateWaitlistEntry का अनुरोध करके, वेटलिस्ट में शामिल होने के लिए अनुरोध किया जा सकता है.
• अगर वेटलिस्ट में शामिल होने की प्रक्रिया पूरी नहीं हो पाती है, तो जवाब में कारोबारी लॉजिक से जुड़ी गड़बड़ी दिखती है.
• अगर CreateWaitlistEntry बार कोशिश कर ली जाती है, तो फिर से वही CreateWaitlistEntry मिलने पर वही जवाब दिखता है.
• अगर CreateWaitlistEntry बार-बार कोशिश नहीं की जा सकती, तो सर्वर फिर से कोशिश करता है. इसके लिए, वही CreateWaitlistEntry मिलता है.
• वेटलिस्ट की एंट्री, व्यापारी/कंपनी/कारोबारी के इंटरफ़ेस में दिखती हैं.
• GetWaitlistEntry को किए जाने वाले कॉल के लिए, बनाई गई वेटलिस्ट में शामिल एंट्री वापस ले ली गई है.

वेटलिस्ट में शामिल होने के स्टेटस और टाइमस्टैंप

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

वेटलिस्ट में शामिल होने की जानकारी मिटाना

• वेटलिस्ट की मौजूदा एंट्री मिटाई जा सकती हैं. मिटाए गए डेटा का रिस्पॉन्स, खाली प्रोटो {} के तौर पर होना चाहिए.

ऑप्ट आउट करें

• पुष्टि करें कि ऑप्ट-आउट किए गए व्यापारियों या कंपनियों को, व्यापारी/कंपनी से ऑप्ट आउट करना सेक्शन में बताया गया है या नहीं.

वेटलिस्ट सेवा फ़ीड का सैंपल (JSON)

वेटलिस्ट सेवा का फ़ीड

व्यापारी/कंपनी से ऑप्ट आउट करना

Google उन व्यापारियों के लिए कुछ जवाब पाने की उम्मीद करता है जिन्होंने पहले वेटलिस्ट की सुविधा चालू की थी, लेकिन उन्होंने ऑप्ट आउट करने का फ़ैसला कर लिया है.

तुरंत ऑप्ट आउट करें

• BatchGetWaitEstimates के अनुरोधों के लिए, CLOSED_OTHER दिखाएं.
• CreateWaitlistEntry के अनुरोधों के लिए WAITLIST_CLOSED लौटाएं.
• वेटलिस्ट में पहले से मौजूद उपयोगकर्ताओं के लिए, GetWaitlistEntry को वापस करने का सही अनुरोध किया गया है.

ज़्यादा लोगों के लिए ऑप्ट आउट करने की सुविधा

• अगर व्यापारी/कंपनी/कारोबारी ने बुकिंग से ऑप्ट-आउट नहीं किया है, तो व्यापारी/कंपनी/कारोबारी के सर्विस फ़ीड से waitlist_rules को हटा दें.
• अगर व्यापारी/कंपनी/कारोबारी, Google के सभी इंटिग्रेशन से ऑप्ट आउट करता है, तो उसे व्यापारी फ़ीड से हटा दें.