खास जानकारी

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

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

पहली इमेज में, वे सभी व्यापारी/कंपनी/कारोबारी दिखाए गए हैं जिन्होंने वेटलिस्ट में शामिल होने के लिए आवेदन किया है. इन्हें ऐक्शन सेंटर पर लॉन्च करने की प्रोसेस के बारे में बताया गया है.

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

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

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

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

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

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

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

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

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

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

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

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

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

उन पार्टनर के लिए दिशा-निर्देश जिनके व्यापारियों/कंपनियों को, सूची में जोड़े गए खरीदारों को मैन्युअल रूप से स्वीकार/अस्वीकार करना होगा

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

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

बुकिंग के लिए वेटलिस्ट में शामिल होने की सुविधा के टेस्ट केस

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

WaitEstimate retrieval

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

वेटलिस्ट में एंट्री बनाना

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

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

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

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

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

ऑप्ट आउट करें

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

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

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

कारोबारी या कंपनी ने Google को वेबसाइट क्रॉल करने की अनुमति नहीं दी है

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

तुरंत ऑप्ट आउट करना

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

ऑप्ट आउट की अवधि बढ़ाना

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