खास जानकारी

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

क्रम से लगाएं

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

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

चेकआउट ऐक्शन

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

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

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

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

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

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

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

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

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

2. आपकी वेब सेवा, Order में मौजूद पेमेंट की जानकारी को प्रोसेस करती है. आम तौर पर, यह इन कार्रवाइयों को करती है:

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

3. आपका एंडपॉइंट, SubmitOrderResponseMessage के साथ रिस्पॉन्स देता है. इसमें OrderUpdate होता है, जिसकी स्थिति CREATED ("ऑर्डर किया गया" खरीदारी की स्थिति), CONFIRMED ("स्वीकार किया गया" खरीदारी की स्थिति) या REJECTED ("अस्वीकार किया गया" खरीदारी की स्थिति) होती है.

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

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

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

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

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

सीक्वेंस डायग्राम

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

ऑर्डर पूरा करने के लिए एंडपॉइंट सेट अप करना

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

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

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

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