खास जानकारी

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

क्रम से लगाएं

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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