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

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

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

पहली इमेज में, 'Google पर रिज़र्व' के ज़रिए वेटलिस्ट में शामिल होने वाले व्यापारियों या कंपनियों को लॉन्च करने की प्रक्रिया बताई गई है.

इमेज 1: इंटिग्रेशन के सबसे बेहतर लेवल
पहली इमेज: इंटिग्रेशन के सबसे बेहतर लेवल

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

इमेज 2: इंटिग्रेशन डेटा फ़्लो का डायग्राम
दूसरी इमेज: इंटिग्रेशन डेटा फ़्लो का डायग्राम

वेटलिस्ट से जुड़े सभी पार्टनर के लिए दिशा-निर्देश

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

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

सामान्य किनारे के केस

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

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

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

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

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

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

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

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

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

वेटलिस्ट में शामिल टेस्ट केस

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

इंतज़ार का अनुमान फिर से हासिल करना

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

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

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

वेटलिस्ट में स्टेटस और टाइमस्टैंप

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

वेटलिस्ट से जुड़ा डेटा मिटाना

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

ऑप्ट आउट करें

  • पुष्टि करें कि ऑप्ट आउट करने वाले व्यापारियों या कंपनियों को व्यापारी ऑप्ट आउट के तौर पर माना जाता है.

वेटलिस्ट सेवा का सैंपल सैंपल (JSON)

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

व्यापारी ऑप्ट आउट

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

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

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

एक्सटेंडेड ऑप्ट आउट

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