इस दस्तावेज़ में, सबसे सही तरीकों के लिए दिशा-निर्देश दिए गए हैं. ज़्यादा जानकारी के लिए, परफ़ॉर्मेंस के बारे में सलाह देखें.
एपीआई का इस्तेमाल कब करना चाहिए
प्रोग्राम के हिसाब से अनुरोध भेजने के लिए
Content API की मदद से, इन्वेंट्री में बदलाव होने पर तुरंत अपडेट भेजे जा सकते हैं. इससे कोई फ़र्क़ नहीं पड़ता कि आपको अपने वर्कफ़्लो के हर हिस्से को ऑटोमेट करना है या अपने ईआरपी (एंटरप्राइज़ रिसोर्स प्लानिंग) सिस्टम में हुक बनाना है.
तुरंत सुझाव पाने के लिए
Content API में, डेटा फ़ीड प्रोसेस होने के बाद ईमेल से खास जानकारी पाने के बजाय, हर अनुरोध का जवाब तुरंत मिलता है. बड़े बैच के अनुरोधों के लिए, पांच से दस सेकंड की देरी हो सकती है.
प्रॉडक्ट डेटा में बार-बार बदलाव करने के लिए
Content API की मदद से, दिन में कई बार तेज़ी से बिकने वाले प्रॉडक्ट की इन्वेंट्री को अपडेट किया जा सकता है. हालांकि, हर बार पूरा डेटा फ़ीड भेजना मुमकिन नहीं है. अगर अपडेट अलग-अलग उपलब्ध होते हैं, तो उन्हें अलग-अलग भेजें. एक साथ कई अपडेट उपलब्ध होने का इंतज़ार न करें, ताकि उन्हें एक साथ भेजा जा सके. इसी तरह, अगर अपडेट बैच में उपलब्ध हैं, तो उन्हें बैच में भेजें. उन्हें अलग-अलग अनुरोधों में न तोड़ें.
कई उप-खाते मैनेज करने के लिए
नए Merchant Center खाते, सिंगल खाते होते हैं. इनमें प्रॉडक्ट डेटा का अपना सेट होता है. यह तरीका ज़्यादातर मामलों में अच्छी तरह काम करता है. हालांकि, जैसे-जैसे आपका खाता बढ़ता है वैसे-वैसे आपको अपने प्रॉडक्ट के लिए, ज़्यादा बेहतर मैनेजमेंट सिस्टम की ज़रूरत पड़ सकती है. अगर आपके साथ ऐसा हो रहा है, तो एक से ज़्यादा क्लाइंट वाले खाते यानी एमसीए का इस्तेमाल करें. खातों की सेवा का इस्तेमाल करके, एमसीए खाते को एपीआई लेवल पर मैनेज किया जा सकता है. इससे प्रोग्राम के हिसाब से उप-खातों को जोड़ा और मैनेज किया जा सकता है. एमसीए खाता पाने के तरीके के बारे में ज़्यादा जानकारी यहां मिल सकती है.
एपीआई का इस्तेमाल कैसे करें
एपीआई का इस्तेमाल, डेटा फ़ीड की तरह न करें
products रिसोर्स का इस्तेमाल करते समय, अपने पूरे प्रॉडक्ट फ़ीड को हर दिन अपडेट करने से बचें.
इसके बजाय, सिर्फ़ उन प्रॉडक्ट का डेटा अपडेट करें जिनमें बदलाव हुआ है. products संसाधन के ज़रिए पूरा डेटा फ़ीड भेजने में, Google और आपको ज़्यादा समय और संसाधनों की ज़रूरत होती है.
अपलोड की गई प्रॉडक्ट की जानकारी को नियमित तौर पर वापस पाने के लिए, एपीआई का इस्तेमाल न करें
अगर आपको किसी Merchant Center खाते में प्रॉडक्ट की जानकारी को मैनेज करना है, तो Content API से products.get या products.list तरीकों का इस्तेमाल करके, नियमित तौर पर प्रॉडक्ट की जानकारी का अनुरोध न करें. जानकारी अपलोड करने वाले क्लाइंट के लिए, इन तरीकों से Content API का इस्तेमाल करने वाले समाधानों को डिज़ाइन करते समय समस्याओं को डीबग करने में मदद मिल सकती है. हालांकि, इन एपीआई का इस्तेमाल ऐसे क्लाइंट, प्रॉडक्ट की जानकारी को बार-बार पाने के लिए नहीं कर सकते. आपके पास अपने प्रॉडक्ट की जानकारी के लिए कोई दूसरा सोर्स होना चाहिए. जैसे, स्थानीय प्रॉडक्ट डेटाबेस. साथ ही, Merchant Center में मौजूद प्रॉडक्ट, उस सोर्स के कॉन्टेंट को दिखाते हों.
प्रॉडक्ट आइटम सबमिट करने के लिए, डेटा फ़ीड और Content API, दोनों का इस्तेमाल न करें
अगर आपको सामान सबमिट करने के लिए एपीआई का इस्तेमाल करना है, तो पक्का करें कि अब प्रॉडक्ट आइटम सबमिट करने के लिए डेटा फ़ीड का इस्तेमाल न किया जा रहा हो. अगर दोनों प्लैटफ़ॉर्म पर आइटम सबमिट किए जाते हैं, तो अनचाहे नतीजे मिल सकते हैं.
क्या एपीआई और डेटा फ़ीड को एक साथ सुरक्षित तरीके से इस्तेमाल किया जा सकता है?
API की Datafeed Service का इस्तेमाल करके, अपने डेटा फ़ीड में बदलाव किया जा सकता है. इससे बड़े पैमाने पर डेटा फ़ीड को मैनेज करना आसान हो जाएगा. हालांकि, ध्यान रखें कि आपको फ़ीड के साथ-साथ एपीआई का इस्तेमाल करके, प्रॉडक्ट नहीं डालने या अपडेट नहीं करने चाहिए. ऐसा करने पर, अनचाहे नतीजे मिल सकते हैं.
फ़ीड और एपीआई, दोनों का एक साथ इस्तेमाल करने के कुछ अन्य उदाहरण यहां दिए गए हैं:
एपीआई से सिर्फ़ पढ़ने के अनुरोध (पाएं या सूची बनाएं) पूरे करना: कुछ कारोबारी या कंपनियां, एपीआई का इस्तेमाल करके अपने प्रॉडक्ट की जानकारी और स्टेटस अपडेट पाना चाहती हैं. यह स्वीकार्य है, क्योंकि प्रॉडक्ट की जानकारी सिर्फ़ फ़ीड से अपडेट होती है.
एपीआई का इस्तेमाल करके, अपने उप-खातों (Accounts Service) और/या खाता-लेवल पर टैक्स और शिपिंग की सेटिंग (Accounttax Service और Shippingsettings Service) मैनेज करें. ये ऐसे फ़ंक्शन नहीं हैं जिन्हें Datafeeds उपलब्ध करा सकता है. इसलिए, इन फ़ंक्शन को मैनेज करने के लिए एपीआई का इस्तेमाल करने में कोई समस्या नहीं है.
मैं डेटा फ़ीड से सिर्फ़ एपीआई का इस्तेमाल करने पर कैसे माइग्रेट करूं या इसका उल्टा कैसे करूं?
अगर फ़िलहाल डेटा फ़ीड का इस्तेमाल किया जा रहा है और आपको सिर्फ़ एपीआई का इस्तेमाल करके प्रॉडक्ट अपडेट करने हैं, तो आपको एपीआई की मदद से अपना प्रॉडक्ट डेटा फिर से अपलोड करना होगा. किसी प्रॉडक्ट की जानकारी अपडेट करने के लिए, products service का इस्तेमाल करने पर, API उस प्रॉडक्ट की जानकारी को कंट्रोल करता है. इसके बाद, डेटा फ़ीड से प्रॉडक्ट को मिटाने या डेटा फ़ीड को मिटाने पर भी, आपके Merchant Center खाते से प्रॉडक्ट की जानकारी नहीं हटेगी. पक्का करें कि अगर आपको प्रॉडक्ट को डेटा फ़ीड या डेटा फ़ीड से हटाना है, तो डेटा फ़ीड में कोई अपडेट न हो. ऐसा न होने पर, डेटा फ़ीड फिर से मालिकाना हक ले लेगा और प्रॉडक्ट को डेटा फ़ीड से हटाने पर, प्रॉडक्ट हट जाएगा.
अगर फ़िलहाल, प्रॉडक्ट की जानकारी के लिए सिर्फ़ एपीआई का इस्तेमाल किया जा रहा है और आपको प्रॉडक्ट की जानकारी के मुख्य सोर्स के तौर पर डेटा फ़ीड का इस्तेमाल करना है, तो अपने Merchant Center खाते में नया डेटा फ़ीड जोड़ें. इसके बाद, वे अपने लिस्ट किए गए प्रॉडक्ट का मालिकाना हक ले लेंगे. अगर आपको ऐसे प्रॉडक्ट हटाने हैं जो सिर्फ़ एपीआई से अपलोड किए गए थे और उनकी समयसीमा खत्म होने से पहले उन्हें हटाना है, तो आपको उन्हें Merchant Center या एपीआई के ज़रिए मिटाना होगा.
Content API for Shopping का इस्तेमाल करके, प्रॉडक्ट को कई देशों में कैसे टारगेट किया जा सकता है?
Content API के ज़रिए सबमिट किए गए प्रॉडक्ट के लिए, विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग को एक से ज़्यादा देशों में टारगेट करने के लिए, Merchant Center में Content API के प्राइमरी फ़ीड में जाकर, अन्य देशों को कॉन्फ़िगर करें. इसके अलावा, products संसाधन में मौजूद shipping फ़ील्ड के ज़रिए भी अन्य देशों को जोड़ा जा सकता है.
Content API के प्राइमरी फ़ीड की सेटिंग में बदलाव करने का तरीका यहां दिया गया है.
ज़्यादा जानकारी के लिए, यह लेख पढ़ें: एक से ज़्यादा देशों में शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग को टारगेट करना.
पक्का करें कि आपकी क्लाइंट लाइब्रेरी अप-टू-डेट हों
अगर Content API के साथ इंटरैक्ट करने के लिए, Google क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो पक्का करें कि आपने अपनी चुनी हुई प्रोग्रामिंग भाषा के लिए पैकेज मैनेजर का इस्तेमाल किया हो. साथ ही, यह भी पक्का करें कि लाइब्रेरी का वर्शन अप-टू-डेट हो. ज़्यादा जानकारी के लिए, सैंपल और लाइब्रेरी में जाकर, अपनी चुनी हुई भाषा के लिए डेवलपर गाइड देखें.
यह पक्का करें कि आपने डेस्टिनेशन एट्रिब्यूट का इस्तेमाल किया हो, ताकि यह कंट्रोल किया जा सके कि अलग-अलग शॉपिंग प्रोग्राम में कौनसे प्रॉडक्ट दिखें
Content API, Merchant Center में कॉन्फ़िगर किए गए Content API फ़ीड की डिफ़ॉल्ट सेटिंग को अपने-आप लागू कर देता है. includedDestinations या excludedDestinations प्रॉडक्ट एट्रिब्यूट का इस्तेमाल करके, किसी फ़ीड में या Content API के ज़रिए, प्रॉडक्ट लेवल पर प्रोग्राम में शामिल होने की सुविधा को कंट्रोल किया जा सकता है.
अगर आपके एपीआई फ़ीड को किसी प्रोग्राम में शामिल किया गया है, जैसे कि 'Google पर खरीदें
>(जिसे पहले Shopping Actions कहा जाता था), लेकिन आपको कुछ प्रॉडक्ट शामिल नहीं करने हैं, तो excludedDestinations एट्रिब्यूट का इस्तेमाल करें और Shopping Actions को वैल्यू के तौर पर डालें. अगर कोई गड़बड़ी नहीं है, तो यह Merchant Center में फ़ीड की डिफ़ॉल्ट सेटिंग को बदल देगा. साथ ही, वह प्रॉडक्ट 'Google पर खरीदें' (पहले इसे Shopping Actions के नाम से जाना जाता था) में नहीं दिखेगा. इसके उलट, अगर आपके फ़ीड को किसी प्रोग्राम के लिए ऑप्ट-इन नहीं किया गया है, जैसे कि Shopping, तो includedDestinations एट्रिब्यूट का इस्तेमाल करके और Shopping_ads को वैल्यू के तौर पर सेट करके, अलग-अलग आइटम शामिल किए जा सकते हैं. इसके बाद, आइटम शॉपिंग विज्ञापनों में दिखने लगेगा.
includedDestinations और excludedDestinations प्रॉडक्ट एट्रिब्यूट के बारे में ज़्यादा जानने के लिए, सहायता केंद्र पर जाएं.
पक्का करें कि आइटम की समयसीमा खत्म होने से पहले उन्हें अपडेट कर दिया गया हो
अगर किसी आइटम की स्थिति में बदलाव नहीं होता है, तो उसे अपडेट करें. ऐसा तब करें, जब आइटम की समयसीमा खत्म होने में 30 दिन बाकी हों या समयसीमा खत्म होने की तय की गई तारीख से पहले. इससे आइटम को बंद होने से बचाया जा सकेगा. अगर आपको कई आइटम अपडेट करने हैं, क्योंकि उनमें से किसी में भी बदलाव नहीं हुआ है या आपको यह पता नहीं चल पा रहा है कि उन्हें पिछली बार कब अपडेट किया गया था, तो सभी आइटम को एक साथ अपडेट न करें. इसके बजाय, उन्हें कई दिनों तक अपडेट करें, ताकि सर्वर पर ज़्यादा लोड न पड़े.
Content API फ़ीड को न मिटाएं. ऐसा करने पर, आपके प्रॉडक्ट दिखना बंद हो सकते हैं
Content API के ज़रिए channel:online वाला प्रॉडक्ट पहली बार अपलोड करने पर, Merchant Center में Content API नाम का एक नया फ़ीड दिखेगा. Content API के ज़रिए channel:local वाला कोई प्रॉडक्ट पहली बार अपलोड करने पर, Merchant Center में एक नया फ़ीड दिखेगा. इसका टाइटल Content API होगा और सबहेडिंग Local Products होगी. पक्का करें कि आपने गलती से ऑनलाइन या स्थानीय Content API फ़ीड न मिटा दिया हो. आपने Content API के ज़रिए Merchant Center में जो ऑनलाइन या स्थानीय प्रॉडक्ट जोड़े हैं वे हटाए गए फ़ीड के हिसाब से हटा दिए जाएंगे.
custombatch तरीके का इस्तेमाल करके, एक ही सेवा के लिए कई अनुरोधों को बैच करना
एक ही सेवा के लिए, एक के बाद एक या एक साथ कई अनुरोध करने के बजाय, एक कस्टमबैच अनुरोध करें. इसमें वे सभी अनुरोध शामिल होने चाहिए जो आपको करने हैं. इस तरह, एपीआई एंडपॉइंट से अनुरोध करने में लगने वाला समय, हर अनुरोध के बजाय सिर्फ़ एक बार कस्टमबैच कॉल के लिए लगता है. यह खास तौर पर तब ज़रूरी होता है, जब आपको क्रम से अनुरोध करने हों.
एक बैच में, एक ही आइटम के लिए कई अपडेट न भेजें
इससे अपडेट के क्रम के बारे में अनिश्चितता की वजह से, उम्मीद के मुताबिक नतीजे नहीं मिलेंगे. साथ ही, विरोध की गड़बड़ी हो सकती है.
जिन आइटम में कोई बदलाव नहीं हुआ है उनके लिए अपडेट न भेजें
पक्का करें कि आपने सिर्फ़ नए, बदले गए या मिटाए गए प्रॉडक्ट आइटम के लिए अनुरोध भेजे हों. ऐसा तब तक करें, जब तक कि आइटम की समयसीमा खत्म न हो जाए.
कीमतों और/या खरीदारी के लिए उपलब्धता में तेज़ी से बदलाव होने पर, पूरक फ़ीड का इस्तेमाल करें
अगर आपको किसी प्रॉडक्ट की कीमत, उपलब्धता या सेल की जानकारी को अप-टू-डेट रखने में समस्या आ रही है, तो सिर्फ़ इन एट्रिब्यूट के लिए अपडेट भेजने के लिए, products संसाधन में मौजूद पूरक फ़ीड का इस्तेमाल करें. पूरक फ़ीड में अपडेट की गई जानकारी कम होती है. इसलिए, किसी तय समय में प्रॉडक्ट के पूरे डेटा को अपडेट करने के मुकाबले, पूरक फ़ीड में ज़्यादा बार अपडेट किया जा सकता है. इससे आपके प्रॉडक्ट की कीमतें और उपलब्धता की जानकारी, लैंडिंग पेजों पर मौजूद जानकारी से मेल खाती रहेगी.
प्रॉडक्ट की कीमत और खरीदारी के लिए उपलब्धता की जानकारी अपडेट करने के लिए, सामान की लिस्टिंग अपने-आप अपडेट होने की सुविधा का इस्तेमाल किया जा सकता है. इसका इस्तेमाल, एपीआई अपडेट के साथ-साथ किया जा सकता है. इससे Merchant Center में मौजूद जानकारी और प्रॉडक्ट के लैंडिंग पेजों पर मौजूद जानकारी के बीच अंतर को कम करने में मदद मिलती है. हालांकि, ध्यान रखें कि इस सुविधा को प्रॉडक्ट की कीमत और खरीदारी के लिए उपलब्धता की सटीक जानकारी से जुड़ी छोटी-मोटी समस्याओं को ठीक करने के लिए डिज़ाइन किया गया है. इसलिए, सामान की लिस्टिंग अपने-आप अपडेट होने की सुविधा, एपीआई के ज़रिए सही जानकारी देने की जगह नहीं ले सकती.
रीफ़्रेश टोकन का इस्तेमाल कब करना चाहिए
रीफ़्रेश टोकन, अनुमति के अनुरोधों के एचटीटीपी हेडर में दिखाया जाता है. इसमें पुष्टि से जुड़ी कई अन्य तरह की जानकारी भी होती है. हालांकि, डेवलपर अक्सर रीफ़्रेश टोकन का इस्तेमाल करना चाहते हैं. इसकी वजह यह है कि इससे उपयोगकर्ता को बार-बार पुष्टि करने के लिए प्रॉम्प्ट करने की ज़रूरत नहीं पड़ती. ऐसा इसलिए, क्योंकि ऐक्सेस टोकन सिर्फ़ 60 मिनट तक मान्य होते हैं.