खास जानकारी

इस खास जानकारी में, Order with Google के फ़्लो की खास जानकारी दी गई है. साथ ही, यह भी बताया गया है कि यह सेवा, आपकी ग्राहक को सामान भेजने वाली वेब सेवा से कैसे इंटरैक्ट करती है.

क्रम से लगाना

The Order with Google यूज़र इंटरफ़ेस में, उपयोगकर्ता के साथ किए गए सभी इंटरैक्शन को हैंडल किया जाता है. जैसे कि उपयोगकर्ता अपने ऑर्डर में मेन्यू आइटम जोड़ते हैं और रेस्टोरेंट की सेवाओं के आधार पर, पिक अप या डिलीवरी का फ़ैसला लेते हैं. यह सुविधा आपके डेटा फ़ीड में मिलने वाली Restaurant, Service, और Menu इकाइयों से मिलती है.

अगला चरण, कार्ट की पुष्टि करने का स्टेज है, जहां उपयोगकर्ता की बनाई गई Cart को आपकी वेब सेवा से प्रोसेस किया जाता है.

चेकआउट कार्रवाई

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

चेकआउट की प्रोसेस इस क्रम में होती है:

1. Order with Google सेवा, CheckoutRequestMessage पर भेजती है, जिसमें Cart शामिल होता है. यह जानकारी आपको सेवा देने वाले वेब एंडपॉइंट पर मिलती है.
2. आपकी वेब सेवा के लिए, Cart में मौजूद सामान की पुष्टि होना ज़रूरी है. ऐसा, मौजूदा कीमतों, उपलब्धता, और सेवा देने वाली कंपनियों के आधार पर किया जाना चाहिए. इसके बाद, कुल कीमत का हिसाब लगाएं. इसमें छूट, टैक्स, और डिलीवरी के शुल्क शामिल होते हैं.
3. आपका एंडपॉइंट CheckoutResponseMessage के साथ जवाब देता है, जिसमें सफल अनुरोधों के लिए बिना बदलाव वाले Cart शामिल होते हैं. FoodErrorExtension को CheckoutResponseMessage में शामिल किया जा सकता है, ताकि प्रोसेसिंग में आने वाली गड़बड़ी को बढ़ाया जा सके. ज़रूरत पड़ने पर, इसमें मामूली बदलाव भी किए जा सकते हैं.

चेतावनी: चेकआउट कार्रवाई के सभी कॉल से ऑर्डर नहीं होता. चेकआउट कार्रवाई कॉल के आधार पर स्थिति बनाए न रखें.

Cart की पुष्टि होने के बाद, उपयोगकर्ता फ़्लो के ऑर्डर सबमिशन के चरण में जा सकता है.

ऑर्डर की कार्रवाई सबमिट करें

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

ऑर्डर सबमिट करने की प्रोसेस इस क्रम में होती है:

1. Order with Google सेवा, SubmitOrderRequestMessage पर भेजती है, जिसमें Order होता है. इसे ग्राहक को सेवा देने वाले आपके वेब सर्विस एंडपॉइंट पर भेजा जाता है. जारी रखने से पहले, आपके बैकएंड को एक और Cart पुष्टि करनी होगी.

2. आपकी वेब सेवा, Order में मिली पैसे चुकाने की जानकारी को प्रोसेस करती है, जो आम तौर पर ये कार्रवाइयां करती हैं:

   1. टोकन की पुष्टि, धोखाधड़ी, और अन्य ज़रूरी शर्तें पूरी करें.
   2. अनुमति दें और कार्ड को चार्ज करें.

3. आपका एंडपॉइंट SubmitOrderResponseMessage के साथ जवाब देता है, जिसमें CREATED की स्थिति वाला एक OrderUpdate ("Ordered" purchase Status), CONFIRMED ("मंज़ूर" परचेज़ स्टेटस) या REJECTED ("अस्वीकार" परचेज़ स्टेटस) होता है.

दिए गए ऑर्डर के साथ, उपयोगकर्ता आपके और Order with Google यूज़र इंटरफ़ेस, दोनों से ऑर्डर की स्थिति के अपडेट पाने की उम्मीद करता है. आपको उपयोगकर्ता को ऑर्डर की पुष्टि करने वाला ईमेल भेजना होगा. इसके अलावा, आप Google को काम के ऑर्डर अपडेट भेजने के लिए, एसिंक्रोनस ऑर्डर एपीआई का इस्तेमाल करते हैं.

एसिंक्रोनस ऑर्डर अपडेट करने की कार्रवाई

आपकी ओर से उपयोगकर्ता सूचनाओं से अलग होने पर, आपको नीचे दिए गए इवेंट के लिए Google को ऑर्डर की स्थिति के अपडेट भी भेजने होंगे:

1. OrderState में हुए बदलाव, जैसे कि CREATED से CONFIRMED और CONFIRMED से IN_TRANSIT में ट्रांज़िशन.
2. ऑर्डर से जुड़े आइटम में बदलाव, जैसे कि कीमत या खरीदारी के लिए उपलब्धता.
3. जब कोई उपयोगकर्ता आपके ग्राहक सहायता चैनलों में से किसी एक से सहायता अनुरोध ट्रिगर करता है.

अपडेट, आपके वेब सर्विस एंडपॉइंट से AsyncOrderUpdateRequestMessage के तौर पर भेजे जाते हैं, जिसमें OrderUpdate होता है. Google AsyncOrderUpdateResponseMessage के साथ जवाब देता है.

क्रम का डायग्राम

नीचे दिए गए उदाहरण से पता चलता है कि ग्राहक को कार्रवाई करने से जुड़ी कार्रवाइयां, आपकी वेब सेवा से कैसे इंटरैक्ट करती हैं. बड़ा करने के लिए क्लिक करें.

ग्राहक को सामान भेजने का एंडपॉइंट सेट अप करें

The Order with Google की कार्रवाइयों में, JSON मैसेज का इस्तेमाल किया जाता है. ऐसा इसलिए, ताकि वे आपकी वेब सेवा से संपर्क कर सकें और खाने के ऑर्डर की प्रोसेसिंग, पुष्टि, और अपडेट मैनेज कर सकें. जब आप 'Google वेब सर्विस' की मदद से अपना ऑर्डर डिज़ाइन करते हैं, तो आपको एक ऐसा यूआरएल एंडपॉइंट तय करना होगा जो 'Google की ऑर्डर करें' सेवा की मदद से मैसेज का अनुरोध करे और Google की सेवा पर वापस आपको मैसेज भेज सके. इन्हें लागू करने के लिए, ये ज़रूरी शर्तें पूरी करना ज़रूरी है:

• आपकी वेब सेवा को JSON सेवा के साथ POST अनुरोध के साथ Google की सेवा का अनुरोध पाने की अनुमति होनी चाहिए.
• आपकी वेब सेवा के लिए सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला यूआरएल एंडपॉइंट होना ज़रूरी है, जिसे पूरा करने का यूआरएल कहते हैं. इसे आप पार्टनर पोर्टल में बताते हैं. ऑर्डर पूरा करने के लिए, यूआरएल का इस्तेमाल किया जाता है. लागू करने की प्रोसेस में दोनों तरह के अनुरोध होने चाहिए.
• आपकी वेब सेवा, Google के मैसेज की पुष्टि कर पाए, इसके लिए, मैसेज की पुष्टि करने के तरीके का इस्तेमाल किया जाना चाहिए.
• यूआरएल एंडपॉइंट का इस्तेमाल करके, आप चेकआउट और ऑर्डर पूरा करने के अनुरोधों को एक ही एंडपॉइंट से मैनेज कर पाएंगे. चेकआउट के लिए आपके पास एक यूआरएल पॉइंट और चेकआउट के लिए, एक अलग एंडपॉइंट नहीं हो सकता.

क्लाइंट लाइब्रेरी

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