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

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

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

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

चाहे आपको अपने वर्कफ़्लो के हर हिस्से को ऑटोमेट करना हो या अपने ईआरपी (एंटरप्राइज़ रिसोर्स प्लानिंग) सिस्टम में एक हुक बनाना हो, 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 उपलब्ध करा सकते हैं, इसलिए इन फ़ंक्शन को प्रबंधित करने के लिए एपीआई का इस्तेमाल करने में कोई दिक्कत नहीं है.

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

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

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

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

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

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

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

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

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

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

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

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

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