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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मैं Shopping के लिए Content API का इस्तेमाल करके, प्रॉडक्ट की मदद से एक से ज़्यादा देशों को कैसे टारगेट करूं?

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

Content API के प्राइमरी फ़ीड की सेटिंग में बदलाव करने का उदाहरण नीचे दिया गया है.

ज़्यादा जानकारी के लिए, देखें: एक से ज़्यादा देशों में शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग को टारगेट करना.

पक्का करना कि आपकी क्लाइंट लाइब्रेरी अप-टू-डेट है

अगर Content API का इस्तेमाल करने के लिए Google की क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो अपनी चुनी हुई प्रोग्रामिंग भाषा के लिए पैकेज मैनेजर का इस्तेमाल ज़रूर करें. साथ ही, यह भी पक्का करें कि लाइब्रेरी का वर्शन अप-टू-डेट हो. ज़्यादा जानकारी के लिए, सैंपल और लाइब्रेरी में अपनी चुनी हुई भाषा के लिए डेवलपर की गाइड देखें.

अलग-अलग शॉपिंग प्रोग्राम में दिखाए जाने वाले प्रॉडक्ट को कंट्रोल करने के लिए, डेस्टिनेशन एट्रिब्यूट का इस्तेमाल करें

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

कस्टमबैच विधि का उपयोग करके समान सेवा के लिए कई अनुरोधों को बैच करें

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

किसी एक सामान के लिए कई अपडेट न भेजें

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

नहीं बदले गए आइटम के लिए अपडेट न भेजें

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

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

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

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

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

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