इस लेख में आपके खाते के लिए मेन्यू एपीआई को चालू करने और इसे उसके साथ इंटिग्रेट करने की प्रोसेस के बारे में बताया गया है. यहां शामिल होने की प्रोसेस और लॉन्च से जुड़ी ज़रूरी शर्तों के बारे में खास जानकारी दी गई है. इंटिग्रेशन की प्रोसेस प्लान करते समय, कृपया यह पेज देखें.
- सेटअप - डेवलपमेंट प्रोसेस के लिए खाते का कॉन्फ़िगरेशन और प्लानिंग.
- डेवलपमेंट - डेटा फ़ीड डेवलपमेंट और जांच.
- लॉन्च - लॉन्च से पहले डेटा का आकलन.
सेटअप
इस चरण में, यह पुष्टि करना ज़रूरी है कि पार्टनर पोर्टल पर आपका खाता पूरी तरह से कॉन्फ़िगर हो गया है. साथ ही, वह स्टैटिक मेन्यू डेटा से जुड़े काम के डेटा फ़ीड स्वीकार करने के लिए तैयार है. अगर आपके पास ऐसा मौजूदा OwG रीडायरेक्ट या RwG इंटिग्रेशन है जिसमें मेन्यू मेटाडेटा जोड़ा जा रहा है, तो आपके मौजूदा खाते को इस इंटिग्रेशन के लिए फिर से इस्तेमाल किया जाएगा. इस प्लैटफ़ॉर्म पर OwG Direct इंटिग्रेशन के बिना या कोई इंटिग्रेशन न होने पर, एक नया खाता बनाया जाता है और ऐक्सेस की जानकारी ईमेल पर शेयर की जाती है.
पार्टनर पोर्टल पर अपने खाते को ऐक्सेस करें और ड्रॉपबॉक्स के कॉन्फ़िगरेशन पेज कॉन्फ़िगरेशन > फ़ीड पर जाएं. मेन्यू डेटा फ़ीड इंटिग्रेशन के लिए, दो तरह के ड्रॉपबॉक्स काम के होते हैं: सामान्य और कारोबारी. कृपया देखें कि दोनों ड्रॉपबॉक्स पर SSH सार्वजनिक कुंजी कॉन्फ़िगर की गई है या नहीं. एसएसएच कुंजियों को कॉन्फ़िगर करने के तरीके के बारे में ज़्यादा जानकारी के लिए, यह पेज देखें.
जेनरिक ड्रॉपबॉक्स
कई तरह के फ़ीड को स्वीकार कर सकता है. ये फ़ीड, अलग-अलग डेटा स्कीमा का पालन कर सकते हैं. स्ट्रक्चर्ड मेन्यू डेटा को स्वीकार करने वाले फ़ीड टाइप को google.food_menu नाम दिया जाता है. आम तौर पर, यह
आपके खाते के लिए शामिल होने की शुरुआत में डिफ़ॉल्ट रूप से चालू
हो जाता है. अगर फ़ीड सबमिट करने की कोशिश करते समय आपको गड़बड़ी का यह मैसेज दिखता है -
"फ़ीड प्रोसेस नहीं हो सकी. आपके फ़ीड को पार्स करते समय, कोई अंदरूनी समस्या हुई. 'google.food_menu' चालू नहीं है. कृपया इसे ठीक करें और फिर से कोशिश करें." पर क्लिक करने पर, इस फ़ीड टाइप को चालू करने के लिए, कृपया Google में मौजूद अपने पीओसी से संपर्क करें.
आखिर में, कृपया कॉन्फ़िगरेशन > संपर्क से जुड़ी जानकारी पेज पर जाएं और पक्का करें कि आपकी सभी संपर्क जानकारी अप-टू-डेट हो.
डेवलेपमेंट
डेवलपमेंट स्टेज में, लागू करने की कोशिश का मुख्य हिस्सा शामिल होता है - डेटा फ़ीड जनरेट करना और उनकी जांच करना. डेटा फ़ीड को हर दिन टारगेट ड्रॉपबॉक्स पर बनाना और सबमिट करना होगा. सैंडबॉक्स में सबमिट किए गए फ़ीड को, सबमिट करने के एक घंटे के अंदर प्रोसेस करना शुरू कर दिया जाता है. प्रोडक्शन फ़ीड को पीएसटी के टाइम ज़ोन के हिसाब से, हर दिन दोपहर 12 बजे प्रोसेस किया जाता है. सिर्फ़ हाल ही में सबमिट किए गए फ़ीड को ही प्रोसेस किया जाता है. फ़ीड जनरेट करते समय, कृपया डेटा फ़ीड की खास जानकारी और सैंपल देखें. हालांकि, प्रॉडक्ट की खास जानकारी को प्रोटोबफ़ फ़ॉर्मैट में दिखाया गया है, लेकिन हमारा सुझाव है कि आप फ़ीड फ़ाइलों को JSON फ़ॉर्मैट में अपलोड करें. ऐसा इसलिए, क्योंकि इससे समस्या को हल करना आसान होता है. इस वजह से, फ़ीड के सैंपल भी JSON फ़ॉर्मैट में दिए जाते हैं.
डेटा फ़ीड की एक फ़ाइल की जांच, फ़ीड की पुष्टि करने वाले ऑनलाइन टूल का इस्तेमाल करके तुरंत की जा सकती है. इस टूल से यह पुष्टि होती है कि फ़ाइल, दिए गए स्पेसिफ़िकेशन के मुताबिक है या नहीं. यह टूल दिखाता है कि फ़ाइल, डेटा स्कीमा से मैच करती है या नहीं. अगर नहीं है, तो यह गड़बड़ियों की सूची दिखाता है. कई फ़ाइलों वाले पूरे डेटा फ़ीड की जांच करने के लिए, उस फ़ीड को सैंडबॉक्स में अपलोड करें. डेटा डालने के बाद, पार्टनर पोर्टल पर नतीजे देखें. फ़ीड का डेटा डालने के दौरान, पुष्टि करने के कुछ और नियम लागू किए जाते हैं. इनसे कुछ कारोबारी लॉजिक और डेटा की क्वालिटी की जांच की जाती है.
लॉन्च करें
सभी इंटिग्रेशन का काम पूरा होने के बाद ही लॉन्च स्टेज शुरू किया जा सकता है. साथ ही, प्रोडक्शन फ़ीड से रेस्टोरेंट के मेन्यू की पूरी इन्वेंट्री को सही तरीके से दिखाया जाता है.
लॉन्च से जुड़ी ज़रूरी शर्तें
इंटिग्रेशन को लॉन्च करने के लिए, इन शर्तों को पूरा करना ज़रूरी है:
- डेटा फ़ीड, प्रोडक्शन एनवायरमेंट में बिना किसी गड़बड़ी के प्रोसेस किए जाते हैं.
- प्रोडक्शन डेटा फ़ीड में, इंटिग्रेशन की शुरुआत में इस इंटिग्रेशन के लिए पूरी इन्वेंट्री का स्कोप शामिल होता है.
- व्यापारी/कंपनी/कारोबारी का ज़्यादातर डेटा, Google Maps पर मौजूद जगहों की जानकारी से मेल खाता है.
- प्रोडक्शन फ़ीड ने डेटा क्वालिटी की जांच में पास कर लिया है.
- इंटिग्रेशन, फ़ूड मेन्यू की सभी नीतियां और ज़रूरी शर्तें पूरी करता है.
डेटा इवैलुएशन
जब प्रोडक्शन डेटा फ़ीड में बिना किसी गड़बड़ी के डेटा डाला जाता है, तब हो सकता है कि मेन्यू डेटा की क्वालिटी का आकलन करने के लिए, सिस्टम में एक अंदरूनी प्रोसेस हो. इस प्रोसेस का मकसद, डेटा क्वालिटी में अंतर ढूंढने की कोशिश करना है. जैसे, पकवान के ब्यौरे में ऐसा कॉन्टेंट जो खाने-पीने की चीज़ से जुड़ा न हो, पकवान के नाम, कीमतें वगैरह मेल न खाती हों. अगर ऐसा कोई नतीजा मिलता है, तो उसके सुझाव, डेवलपमेंट टीम के साथ शेयर किए जाएंगे.