सबसे सही तरीके

इस दस्तावेज़ में, सबसे सही तरीके के लिए दिशा-निर्देश दिए गए हैं. ज़्यादा जानकारी के लिए, परफ़ॉर्मेंस के बारे में सलाह देखें.

एपीआई का इस्तेमाल कब करना चाहिए

प्रोग्राम के हिसाब से अनुरोध भेजने के लिए

भले ही, आपको अपने वर्कफ़्लो के हर हिस्से को ऑटोमेट करना हो या अपने ईआरपी (Enterprise Resource Planning) सिस्टम में हुक बनाना हो, Content API की मदद से इन्वेंट्री में बदलाव होने के तुरंत बाद अपडेट भेजे जा सकते हैं.

तुरंत सुझाव या राय पाने के लिए

Content API में, आपको हर अनुरोध का जवाब तुरंत मिलता है. इसके लिए, आपको डेटा फ़ीड प्रोसेस होने के बाद ईमेल की समरी का इंतज़ार नहीं करना पड़ता. एक साथ कई अनुरोध करने पर, पांच से 10 सेकंड तक इंतज़ार करना पड़ सकता है.

प्रॉडक्ट डेटा में बार-बार बदलाव करने के लिए

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

कई उप-खाते मैनेज करने के लिए

नए बनाए गए Merchant Center खाते, सिंगल खाते होते हैं. इनमें प्रॉडक्ट डेटा का अपना सेट होता है. यह तरीका ज़्यादातर मामलों में अच्छा काम करता है. हालांकि, जैसे-जैसे आपका खाता बढ़ता है, आपको अपने प्रॉडक्ट के लिए ज़्यादा जटिल मैनेजमेंट सिस्टम की ज़रूरत पड़ सकती है. अगर आपके मामले में ऐसा है, तो एक से ज़्यादा क्लाइंट वाले खाते या एमसीए का इस्तेमाल करें. खाता सेवा की मदद से, एमसीए खाते को एपीआई-लेवल पर मैनेज किया जा सकता है. साथ ही, प्रोग्राम के हिसाब से उप-खाते जोड़े और मैनेज किए जा सकते हैं. एमसीए खाता पाने के तरीके के बारे में ज़्यादा जानकारी यहां मिल सकती है.

एपीआई का इस्तेमाल कैसे करें

एपीआई का इस्तेमाल डेटा फ़ीड की तरह न करें

products संसाधन का इस्तेमाल करते समय, अपने पूरे प्रॉडक्ट फ़ीड को रोज़ अपडेट करने से बचें. इसके बजाय, सिर्फ़ उन प्रॉडक्ट को अपडेट करें जिनका डेटा असल में बदला है. products रिसॉर्स की मदद से अपना पूरा डेटा फ़ीड भेजने पर, Google और आपके लिए ज़्यादा समय और संसाधनों की ज़रूरत होती है.

अपलोड की गई प्रॉडक्ट की जानकारी को नियमित तौर पर वापस पाने के लिए, एपीआई का इस्तेमाल न करें

अगर किसी Merchant Center खाते में प्रॉडक्ट की जानकारी मैनेज करने की ज़िम्मेदारी आपकी है, तो products.get या products.list तरीकों का इस्तेमाल करके, Content API से प्रॉडक्ट की जानकारी का अनुरोध नियमित तौर पर न करें. जानकारी अपलोड करने वाले क्लाइंट के लिए, इन तरीकों से Content API का इस्तेमाल करने वाले समाधान डिज़ाइन करते समय, समस्याओं को डीबग करने में मदद मिल सकती है. हालांकि, इनका मकसद ऐसे क्लाइंट के लिए, प्रॉडक्ट की जानकारी को नियमित तौर पर वापस पाने का नहीं है. आपके पास अपने प्रॉडक्ट की जानकारी के लिए, स्थानीय प्रॉडक्ट डेटाबेस जैसा कोई दूसरा सोर्स होना चाहिए. साथ ही, Merchant Center में मौजूद प्रॉडक्ट में उस सोर्स का कॉन्टेंट दिखना चाहिए.

प्रॉडक्ट आइटम सबमिट करने के लिए, डेटा फ़ीड और Content API, दोनों का इस्तेमाल न करें

अगर आपको आइटम सबमिट करने के लिए एपीआई का इस्तेमाल करना है, तो पक्का करें कि प्रॉडक्ट आइटम सबमिट करने के लिए, अब डेटा फ़ीड का इस्तेमाल न किया जा रहा हो. अगर दोनों माध्यमों से आइटम सबमिट किए जाते रहते हैं, तो आपको अनचाहे नतीजे मिल सकते हैं.

क्या एपीआई और डेटा फ़ीड को एक साथ सुरक्षित तरीके से इस्तेमाल किया जा सकता है?

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

फ़ीड और एपीआई का इस्तेमाल एक साथ करने के कुछ अन्य स्वीकार किए गए तरीके यहां दिए गए हैं:

  • एपीआई से रीड-ओनली अनुरोध (get या list) को लागू करना: कुछ व्यापारी/कंपनी/कारोबारी, अपने प्रॉडक्ट की जानकारी और स्थिति से जुड़े अपडेट पाने के लिए, एपीआई का इस्तेमाल करना चाहते हैं. ऐसा किया जा सकता है, क्योंकि प्रॉडक्ट की जानकारी सिर्फ़ फ़ीड से अपडेट होती है.

  • अपने उप-खाते (Accounts Service) और/या खाता-लेवल पर टैक्स और शिपिंग की सेटिंग (Accounttax Service और Shippingsettings Service) मैनेज करने के लिए, एपीआई का इस्तेमाल करना. ये ऐसे फ़ंक्शन नहीं हैं जिन्हें डेटाफ़ीड उपलब्ध करा सकते हैं. इसलिए, इन फ़ंक्शन को मैनेज करने के लिए एपीआई का इस्तेमाल करने में कोई समस्या नहीं है.

मैं डेटा फ़ीड का इस्तेमाल करने से, सिर्फ़ एपीआई का इस्तेमाल करने पर या इसके उलट कैसे माइग्रेट करूं?

अगर फ़िलहाल डेटा फ़ीड का इस्तेमाल किया जा रहा है और आपको प्रॉडक्ट अपडेट करने के लिए सिर्फ़ एपीआई का इस्तेमाल करना है, तो आपको एपीआई की मदद से अपना प्रॉडक्ट डेटा फिर से अपलोड करना होगा. किसी प्रॉडक्ट को अपडेट करने के लिए products service का इस्तेमाल करने पर, एपीआई प्रॉडक्ट की जानकारी को कंट्रोल करता है. साथ ही, डेटा फ़ीड से प्रॉडक्ट को मिटाने या डेटा फ़ीड को मिटाने पर, अब आपके 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, आपके Content API फ़ीड के लिए डिफ़ॉल्ट सेटिंग अपने-आप लागू कर देता है. ऐसा इसलिए होता है, क्योंकि इसे Merchant Center में कॉन्फ़िगर किया गया था. किसी फ़ीड में या Content API की मदद से, प्रॉडक्ट के लेवल पर प्रोग्राम में हिस्सा लेने की सुविधा को कंट्रोल करने के लिए, includedDestinations या excludedDestinations प्रॉडक्ट एट्रिब्यूट का इस्तेमाल किया जा सकता है.

अगर आपके एपीआई फ़ीड को किसी प्रोग्राम के लिए ऑप्ट इन किया गया है, जैसे कि '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 और सबहेडिंग लोकल प्रॉडक्ट होगी. पक्का करें कि आपने गलती से ऑनलाइन या स्थानीय Content API फ़ीड को न मिटाया हो. मिटाए गए फ़ीड के आधार पर, Content API के ज़रिए Merchant Center में जोड़े गए ऑनलाइन या स्थानीय प्रॉडक्ट हटा दिए जाएंगे.

कस्टमबैच तरीके का इस्तेमाल करके, एक ही सेवा के लिए कई अनुरोध एक साथ करना

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

एक ही बैच में किसी एक आइटम के लिए कई अपडेट न भेजें

अपडेट के क्रम के बारे में अनिश्चितता की वजह से, इससे अनचाहे नतीजे मिलेंगे. साथ ही, इससे कन्फ़िगरेशन में गड़बड़ी की समस्या हो सकती है.

जिन आइटम में कोई बदलाव नहीं हुआ है उनके लिए अपडेट न भेजें

पक्का करें कि आपने सिर्फ़ नए, बदले गए या मिटाए गए प्रॉडक्ट आइटम के लिए अनुरोध भेजा हो. ऐसा तब तक करें, जब तक कि आइटम की समयसीमा खत्म न हो जाए.

अगर कीमतों और/या खरीदारी के लिए उपलब्धता में तेज़ी से बदलाव होता है, तो सप्लीमेंटल फ़ीड का इस्तेमाल करें

अगर आपको किसी प्रॉडक्ट की कीमत, उपलब्धता या बिक्री की जानकारी को अप-टू-डेट रखने में समस्या आ रही है, तो सिर्फ़ उन एट्रिब्यूट के लिए अपडेट भेजने के लिए, products संसाधन में मौजूद सप्लीमेंटल फ़ीड का इस्तेमाल करें. पूरक फ़ीड के अपडेट छोटे होते हैं. इसलिए, किसी तय समयावधि में पूरे प्रॉडक्ट के अपडेट की तुलना में, पूरक फ़ीड के ज़्यादा अपडेट किए जा सकते हैं. इससे आपके प्रॉडक्ट की कीमतों और उपलब्धता को लैंडिंग पेजों के मुताबिक रखने में मदद मिलेगी.

प्रॉडक्ट की कीमत और खरीदारी के लिए उपलब्धता की जानकारी अपडेट करने का एक और तरीका है, सामान की लिस्टिंग अपने-आप अपडेट होने की सुविधा का इस्तेमाल करना. इसका इस्तेमाल, एपीआई अपडेट के साथ-साथ किया जा सकता है. इससे Merchant Center में मौजूद जानकारी और प्रॉडक्ट के लैंडिंग पेजों पर मौजूद जानकारी के बीच अंतर को रोकने में मदद मिलती है. हालांकि, ध्यान रखें कि इस सुविधा को प्रॉडक्ट की कीमत और खरीदारी के लिए उपलब्धता की सटीक जानकारी से जुड़ी छोटी समस्याओं को ठीक करने के लिए डिज़ाइन किया गया है. इसलिए, सामान की लिस्टिंग अपने-आप अपडेट होने की सुविधा, एपीआई के ज़रिए सही जानकारी देने की जगह नहीं ले सकती.

रीफ़्रेश टोकन का इस्तेमाल कब करना चाहिए

रीफ़्रेश टोकन, अनुमति के अनुरोधों के एचटीटीपी हेडर में दिखाया जाता है. इसमें पुष्टि से जुड़ी कई अन्य जानकारी होती है. हालांकि, डेवलपर अक्सर रीफ़्रेश टोकन का इस्तेमाल करना चाहते हैं, क्योंकि इससे उपयोगकर्ता को बार-बार पुष्टि करने के लिए नहीं कहना पड़ता. ऐसा इसलिए, क्योंकि ऐक्सेस टोकन सिर्फ़ 60 मिनट के लिए मान्य होते हैं.