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

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

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

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

इमेज 1: इंटिग्रेशन के हाई लेवल
पहली इमेज: इंटिग्रेशन के लिए, बड़े लेवल के चरण

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

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

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

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

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

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

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

इमेज 3: वेटलिस्ट की स्थिति का फ़्लोचार्ट
चित्र: 3 वेटलिस्ट की स्थिति का फ़्लोचार्ट

आम तौर पर मिलने वाले केस

वेटलिस्ट में शामिल होने और उनके लिए पसंदीदा तरीकों के सामान्य उदाहरण यहां दिए गए हैं.

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

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

वेटलिस्ट पार्टनर के लिए दिशा-निर्देश

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

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

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

अगर व्यापारी/कंपनी को वेटलिस्ट में शामिल होने के नए अनुरोधों को मैन्युअल तरीके से स्वीकार या अस्वीकार करना है, तो कुछ और तरीके अपनाने होंगे:

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

वेटलिस्ट टेस्ट के केस

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

Wait शैली को वापस पाने की प्रोसेस

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

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

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

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

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

वेटलिस्ट में दिया गया डेटा मिटाना

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

ऑप्ट आउट करें

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

वेटलिस्ट सेवा फ़ीड का नमूना (JSON)

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

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

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

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

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

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

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