Merchant Center में प्रॉडक्ट डेटा अपलोड करने के लिए, फ़ाइल पर आधारित फ़ीड, Merchant API या दोनों का इस्तेमाल किया जा सकता है:
- फ़ाइल पर आधारित प्रॉडक्ट फ़ीड: एसएफ़टीपी, Google Cloud Storage, Google Sheets या फ़ीड पाने के शेड्यूल का इस्तेमाल करके, CSV, TSV या एक्सएमएल फ़ाइलें अपलोड करें.
- Merchant API: प्रॉडक्ट डेटा में बदलाव होने पर, इंक्रीमेंटल अपडेट के लिए सीधे अपने बैकएंड से प्रोग्राम के हिसाब से अनुरोध भेजें. साथ ही, समय-समय पर पूरे कैटलॉग को सिंक करें.
इस गाइड में दोनों तरीकों की तुलना की गई है. साथ ही, यह बताया गया है कि एक के बजाय दूसरे तरीके का इस्तेमाल कब करना चाहिए या दोनों का इस्तेमाल एक साथ कब करना चाहिए. अगर आपको अपने कुछ या सभी प्रॉडक्ट को फ़ाइल फ़ीड से एपीआई पर माइग्रेट करना है, तो इस गाइड में सिलसिलेवार तरीके से माइग्रेट करने की प्लेबुक भी दी गई है.
डेटा सोर्स का तरीका चुनें
अपने कैटलॉग में होने वाले बदलावों, बैकएंड आर्किटेक्चर, और ऑपरेशनल वर्कफ़्लो का आकलन करें. इससे आपको यह तय करने में मदद मिलेगी कि आपको Merchant API, फ़ाइल फ़ीड या हाइब्रिड सेटअप में से किसका इस्तेमाल करना चाहिए.
Merchant API का इस्तेमाल कब करना चाहिए
एपीआई वाले प्राइमरी डेटा सोर्स का इस्तेमाल तब करें, जब:
- सीधे प्रोग्राम के हिसाब से इंटिग्रेशन: आपको फ़ाइलें जनरेट करने और फ़ाइल ट्रांसफ़र पाइपलाइन (जैसे, एसएफ़टीपी या Google Cloud Storage) को मैनेज करने के बजाय, सीधे अपने बैकएंड से एपीआई को कॉल करना पसंद है.
- कीमत और इन्वेंट्री में बार-बार होने वाले बदलाव: आपके प्रॉडक्ट की कीमतों या स्टॉक के लेवल में दिन भर बार-बार बदलाव होते हैं.
- डेटा में बदलाव होने पर तुरंत अपडेट करना: आपको प्रॉडक्ट में हुए बदलावों की जानकारी Google को तुरंत भेजनी है. इसके लिए, आपको फ़ाइल जनरेट करने और उसे अपलोड करने के अगले शेड्यूल का इंतज़ार नहीं करना है.
- कैटलॉग में समय-समय पर अपडेट करना: आपको प्रॉडक्ट में बदलाव होने पर, उन्हें अलग-अलग जोड़ना, अपडेट करना या मिटाना है. इसके लिए, आपको हर बार अपना पूरा कैटलॉग फिर से अपलोड नहीं करना है.
- एट्रिब्यूट की वैल्यू को कुछ हद तक अपडेट करना: आपको प्रॉडक्ट के कुछ फ़ील्ड अपडेट करने हैं. जैसे,
productInputs.patchका इस्तेमाल करकेpriceयाavailabilityको अपडेट करना. इसके लिए, आपको प्रॉडक्ट का पूरा पेलोड फिर से भेजने की ज़रूरत नहीं है.
फ़ाइल फ़ीड का इस्तेमाल कब करना चाहिए
फ़ाइल पर आधारित प्राइमरी डेटा सोर्स का इस्तेमाल तब करें, जब:
- स्टैटिक कैटलॉग: आपके प्रॉडक्ट डेटा में कभी-कभार ही बदलाव होता है. उदाहरण के लिए, दिन में एक बार या इससे कम.
- डेल्टा ट्रैकिंग के बिना सिर्फ़ स्नैपशॉट वाला बैकएंड: आपका बैकएंड सिर्फ़ पूरे कैटलॉग के स्नैपशॉट एक्सपोर्ट करता है. यह आइटम के लेवल पर होने वाले बदलावों या प्रॉडक्ट को साफ़ तौर पर मिटाए जाने को ट्रैक नहीं कर सकता.
- स्प्रेडशीट पर आधारित वर्कफ़्लो: नॉन-इंजीनियरिंग टीमें, सीधे Google Sheets या CSV फ़ाइलों में प्रॉडक्ट डेटा को क्यूरेट करती हैं या उसे बदलती हैं.
- कम रखरखाव वाले काम: आपको शेड्यूल किए गए फ़ाइल एक्सपोर्ट की सुविधा पसंद है. इसमें Merchant Center, फ़ाइल को फ़ेच करने और स्नैपशॉट प्रोसेस करने का काम करता है. इसके बजाय, आपको एपीआई इंटिग्रेशन का इस्तेमाल करना पसंद नहीं है. इसमें अनुरोध की रफ़्तार, फिर से कोशिश करने की प्रोसेस, और समय-समय पर पूरे कैटलॉग को सिंक करने की प्रोसेस शामिल होती है.
दोनों का इस्तेमाल कब करना चाहिए
Merchant Center के एक ही खाते में, फ़ाइल फ़ीड और Merchant API को इन स्थितियों में जोड़ा जा सकता है:
- अलग-अलग प्रॉडक्ट कैटलॉग: Merchant API का इस्तेमाल, तेज़ी से बदलने वाले प्रॉडक्ट के लिए किया जाता है. जैसे, फ़्लैश सेल या ज़्यादा टर्नओवर वाली इन्वेंट्री. वहीं, फ़ाइल फ़ीड का इस्तेमाल, स्टैटिक कैटलॉग सेगमेंट या अलग-अलग प्रॉडक्ट लाइन के लिए किया जाता है. पक्का करें कि हर प्रॉडक्ट को सिर्फ़ एक प्राइमरी डेटा सोर्स से अपलोड किया गया हो. एक साथ इस्तेमाल और प्राइमरी डेटा सोर्स का मालिकाना हक लेख देखें.
- फ़ाइल पर आधारित पूरक फ़ीड के साथ एपीआई प्राइमरी डेटा: एपीआई प्राइमरी डेटा सोर्स के ज़रिए, मुख्य प्रॉडक्ट डेटा को मैनेज किया जाता है. वहीं, नॉन-इंजीनियरिंग टीमें या थर्ड पार्टी पार्टनर, फ़ाइल पर आधारित पूरक फ़ीड (जैसे, Google Sheets या CSV फ़ाइलें) के ज़रिए अतिरिक्त एट्रिब्यूट उपलब्ध कराते हैं. ये फ़ीड, एट्रिब्यूट के नियमों के साथ जुड़े होते हैं. इसके अलावा, ऐसा भी हो सकता है कि एपीआई प्राइमरी डेटा सोर्स के ज़रिए अतिरिक्त एट्रिब्यूट उपलब्ध कराए जाएं और फ़ाइल पर आधारित पूरक फ़ीड के ज़रिए मुख्य प्रॉडक्ट डेटा को मैनेज किया जाए.
- कुछ डेटा या कुछ चरणों में डेटा माइग्रेट करना: इसमें कुछ खास मार्केट, कैटगरी या उप-खातों को एपीआई पर माइग्रेट किया जाता है. हालांकि, बाकी कैटलॉग को फ़ाइल फ़ीड में ही रखा जाता है.
अगर आपको अपने कुछ या सभी प्रॉडक्ट, फ़ाइल फ़ीड से Merchant API पर माइग्रेट करने हैं, तो माइग्रेशन की सिलसिलेवार गाइड में दिया गया तरीका अपनाएं.
आर्किटेक्चर में मुख्य अंतर
फ़ाइल फ़ीड और पुश-आधारित Merchant API में, Google के प्रॉडक्ट डेटा को प्रोसेस और मैनेज करने के तरीके में अंतर होता है:
| सिद्धांत | फ़ाइल फ़ीड | Merchant API |
|---|---|---|
| इंटिग्रेशन मॉडल | ऑफ़लाइन फ़ाइल डंप: अपने कैटलॉग को किसी फ़ाइल में एक्सपोर्ट करें. इसके बाद, एसएफ़टीपी, Google Cloud Storage, Google Sheets या फ़ीड पाने के शेड्यूल का इस्तेमाल करके उसे ट्रांसफ़र करें. | डायरेक्ट प्रोग्रामैटिक इंटिग्रेशन: आपका बैकएंड, सीधे एपीआई एंडपॉइंट पर अनुरोध भेजता है. |
| म्यूटेशन ग्रैन्युलैरिटी | एक साथ कई आइटम प्रोसेस करना: किसी एक आइटम में बदलाव करने पर, आम तौर पर पूरी फ़ाइल को फिर से प्रोसेस करना पड़ता है. | अलग-अलग प्रॉडक्ट के लिए लेन-देन: सिर्फ़ उन प्रॉडक्ट को डाला जा सकता है, पैच किया जा सकता है या मिटाया जा सकता है जिनमें बदलाव हुआ है. |
| सिंक करने का समय | बैच सिंक्रनाइज़ेशन: बदलाव आपके बैकएंड में तब तक सेव रहते हैं, जब तक कि फ़ाइल एक्सपोर्ट और ट्रांसफ़र करने का अगला शेड्यूल नहीं आता. | तुरंत या शेड्यूल किए गए कॉल: समय-समय पर होने वाले पूरे सिंक के साथ-साथ, इंक्रीमेंटल बदलावों को तुरंत भेजा जा सकता है. |
| डेटा मिटाने का तरीका | इंप्लिसिट (स्नैपशॉट): हर फ़ाइल एक पूरा स्नैपशॉट होती है. अपनी प्राइमरी फ़ाइल से कोई लाइन हटाने पर, प्रॉडक्ट मिट जाता है. | साफ़ तौर पर: स्नैपशॉट का कोई कॉन्सेप्ट नहीं है. बंद किए गए प्रॉडक्ट को हटाने के लिए, productInputs.delete को कॉल करें. |
| संसाधन का प्रज़ेंटेशन | सिंगल स्टेट: आपकी फ़ाइल की पंक्तियां, रॉ इनपुट को दिखाती हैं. | रॉ और प्रोसेस किए गए डेटा को अलग-अलग करना: एपीआई, डेटा को ProductInput (आपका रॉ इनपुट) और Product (प्रोसेस किया गया फ़ाइनल डेटा) में बांटता है. |
| एट्रिब्यूट (फ़ीड) के नियम | Merchant Center के यूज़र इंटरफ़ेस (यूआई) में, रॉ फ़ाइल के कॉलम पर लागू किया गया. | Merchant Center के यूज़र इंटरफ़ेस (यूआई) में काम करता है. एपीआई डेटा को तीसरे पक्ष की पूरक फ़ाइलों के साथ मर्ज करते समय ज़रूरी है. अगर आपके बैकएंड में सिंगल-सोर्स ट्रांसफ़ॉर्मेशन को मैनेज किया जाता है, तो यह ज़रूरी नहीं है. |
एक साथ इस्तेमाल करना और प्राइमरी डेटा सोर्स का मालिकाना हक ("सबसे हाल ही में अपडेट किया गया डेटा सोर्स इस्तेमाल किया जाएगा")
एक ही Merchant Center खाते में, फ़ाइल फ़ीड और एपीआई, दोनों का इस्तेमाल किया जा सकता है. हालांकि, हमारा सुझाव है कि किसी प्रॉडक्ट को जोड़ने के लिए, इनमें से किसी एक तरीके का ही इस्तेमाल करें.
Merchant Center, "लास्ट अपडेट विंस" मॉडल पर काम करता है. जिस प्राइमरी डेटा सोर्स (एपीआई या फ़ाइल फ़ीड) ने हाल ही में प्रॉडक्ट डेटा को पुश किया है उसे उस प्रॉडक्ट के डेटा का प्राइमरी मालिकाना हक मिलता है:
- जब फ़ाइल डेटा सोर्स में प्रॉडक्ट मौजूद हो: अगर किसी प्रॉडक्ट को बाद में अपलोड की जाने वाली फ़ाइल में शामिल नहीं किया जाता है, तो वह प्रॉडक्ट अपने-आप मिट जाता है. इससे वह प्रॉडक्ट Merchant Center से हट जाता है.
- जब एपीआई डेटा सोर्स के पास प्रॉडक्ट का मालिकाना हक होता है: फ़ाइल अपलोड से प्रॉडक्ट को हटाने पर कोई असर नहीं पड़ता, क्योंकि फ़ाइल फ़ीड के पास अब प्रॉडक्ट का मालिकाना हक नहीं है.
इसे हटाने के लिए, आपको
accounts.productInputs.deleteपर कॉल करना होगा. - गलती से मालिकाना हक वापस मिलने का जोखिम: अगर एपीआई पुश के बाद अपडेट की गई फ़ाइल फ़ीड चलती है और उसमें प्रॉडक्ट शामिल है, तो फ़ाइल डेटा सोर्स को मालिकाना हक वापस मिल जाता है. इसके बाद, फ़ाइल से प्रॉडक्ट को हटाने पर, वह अचानक मिट जाएगा.
एपीआई और फ़ाइल वाले प्राइमरी डेटा सोर्स, दोनों का इस्तेमाल करके एक ही प्रॉडक्ट पर एक साथ अपडेट न करें. इससे, एपीआई अपडेट के अचानक मिटने या उनके न होने की समस्या से बचा जा सकता है.
एपीआई से जुड़ी ज़रूरी बातें
Merchant API को लागू करने से पहले, इसके इन अहम व्यवहारों को समझें:
ज़रूरत के हिसाब से डेटा सोर्स (भाषा या लेबल के बिना)
फ़ाइल फ़ीड के लिए, आपको पहले से ही टारगेट फ़ीड का लेबल और भाषा तय करनी होती है. हालांकि, Merchant API की मदद से, feedLabel या contentLanguage तय किए बिना भी प्राइमरी डेटा सोर्स बनाए जा सकते हैं.
- आसानी से अपलोड करने की सुविधा: इससे आपको किसी भी भाषा या फ़ीड लेबल के कॉम्बिनेशन वाले प्रॉडक्ट, एक ही डेटा सोर्स में अपलोड करने की सुविधा मिलती है.
- आसान मैनेजमेंट: आपको हर टारगेट मार्केट के लिए, अलग-अलग डेटा सोर्स बनाने और मैनेज करने की ज़रूरत नहीं है. ध्यान दें: डेटा सोर्स की रणनीति चुनने के बारे में ज़्यादा जानने के लिए, डेटा सोर्स की रणनीति चुनें लेख पढ़ें.
सिंक करने की रणनीति और कोटा
फ़ाइल फ़ीड में, पूरा कैटलॉग एक ही बैच में अपलोड किया जाता है. हालांकि, Merchant API के इंटिग्रेशन को इस तरह डिज़ाइन करें कि वह इंक्रीमेंटल अपडेट और समय-समय पर होने वाले फ़ुल सिंक, दोनों के साथ काम करे:
- इंक्रीमेंटल अपडेट को समय-समय पर होने वाले फ़ुल सिंक के साथ जोड़ें: अपने बैकएंड में प्रॉडक्ट एट्रिब्यूट में बदलाव होने पर,
productInputs.insertयाproductInputs.patchअनुरोध भेजें. सिर्फ़ इंक्रीमेंटल अपडेट पर भरोसा करने से, समय के साथ आपका डेटा सिंक से बाहर हो सकता है. इसलिए, अपने कैटलॉग को सोर्स ऑफ़ ट्रुथ के साथ मैच करने के लिए, समय-समय पर पूरा सिंक भी करें. इससे 30 दिनों के बाद प्रॉडक्ट की समयसीमा खत्म होने की तारीख भी रीफ़्रेश हो जाती है. आपको कितनी बार फ़ुल सिंक करना है, यह आपके कैटलॉग के साइज़ और उपलब्ध एपीआई कोटा पर निर्भर करता है. - एपीआई कोटा का ध्यान रखते हुए अनुरोध करें: अपने सभी प्रॉडक्ट के लिए, एपीआई को एक साथ कॉल न करें. बढ़ने वाले बदलावों को उनके होने पर भेजा जा सकता है. हालांकि, पूरे सिंक के अनुरोधों को पूरे दिन में समान रूप से फैलाएं, ताकि आप हर मिनट और हर दिन के लिए तय किए गए करने का तरीका कोटा के अंदर रहें. ज़्यादा जानकारी के लिए, कोटा और सीमाएं और अपने प्रॉडक्ट में बार-बार अपडेट करना लेख पढ़ें.
इंटिग्रेशन की जांच करना
प्रोडक्शन एनवायरमेंट में जाने से पहले, सुरक्षित एनवायरमेंट में अपने इंटिग्रेशन लॉजिक की पुष्टि करें.
टेस्ट खातों का इस्तेमाल करना
प्रोडक्शन में बदलाव करने से पहले, हमारा सुझाव है कि आप सैंडबॉक्स किए गए टेस्ट खाते में, माइग्रेशन के शुरुआती चरणों को पूरा करें:
- टेस्ट खाता बनाएं: लाइव विज्ञापनों या मुफ़्त में दिखाई जाने वाली लिस्टिंग पर असर डाले बिना, सुरक्षित तरीके से एक्सपेरिमेंट करने के लिए, एक अलग टेस्ट खाता सेट अप करें.
- एपीआई डेटा सोर्स बनाना: एपीआई प्राइमरी डेटा सोर्स बनाने की प्रैक्टिस करें.
- एट्रिब्यूट के नियमों की जांच करना: डेटा ट्रांसफ़ॉर्मेशन और पूरक फ़ीड के जॉइन की पुष्टि करें.
- पेलोड और प्रॉडक्ट कुंजियों की पुष्टि करना: एसकेयू केसिंग, एन्कोडिंग, और गड़बड़ी को मैनेज करने की सुविधा की पुष्टि करने के लिए, सैंपल प्रॉडक्ट पुश करें.
ज़्यादा जानकारी के लिए, पहला चरण: टेस्ट खाते बनाना और टेस्ट खाते गाइड देखें.
प्रॉडक्ट कुंजी के अलाइनमेंट की पुष्टि करना
पक्का करें कि प्रोग्रामैटिक पेलोड प्रॉडक्ट कुंजी, आपकी फ़ाइल फ़ीड के एसकेयू से पूरी तरह मेल खाती हो. Google, प्रॉडक्ट की पहचान करने के लिए इन चीज़ों को जोड़ता है:
offerId(फ़ाइल फ़ीड में इसेidकहा जाता है. यह केस-सेंसिटिव होता है)contentLanguage(उदाहरण के लिए,en)feedLabel(उदाहरण के लिए,US)
खास वर्ण और एन्कोडिंग
अगर आपके प्रॉडक्ट आइडेंटिफ़ायर में /, % या ~ जैसे वर्ण शामिल हैं, तो अपने एपीआई कॉल में एन्कोड किए गए फ़ॉर्मैट (अनपैडेड base64url एन्कोडिंग) का इस्तेमाल करें. ज़्यादा जानकारी के लिए, ProductInput.name देखें
कॉन्करंसी कंट्रोल
रीयल-टाइम इंटिग्रेशन में, नेटवर्क लेटेंसी की वजह से अपडेट बिना किसी क्रम के आ सकते हैं. पुराने अपडेट से नए डेटा को ओवरराइट होने से रोकने के लिए, ProductInput रिसॉर्स में versionNumber फ़ील्ड का इस्तेमाल करें.
माइग्रेशन के लिए सिलसिलेवार निर्देशों की प्लेबुक
अगर आपको अपने कुछ या सभी प्रॉडक्ट को फ़ाइल फ़ीड से Merchant API पर माइग्रेट करना है, तो इस प्लेबुक में बताया गया तरीका अपनाएं. इससे इंप्रेशन या विज्ञापन दिखाने के इतिहास को खोए बिना, प्रॉडक्ट को माइग्रेट किया जा सकेगा.
1. टेस्ट खाते में माइग्रेशन की रिहर्सल करना
प्रोडक्शन में बदलाव करने से पहले, accounts.createTestAccount तरीके का इस्तेमाल करके, सैंडबॉक्स किया गया टेस्ट खाता बनाएं. इसके लिए, टेस्ट खाते वाली गाइड देखें. टेस्ट खाते, एक अलग एनवायरमेंट उपलब्ध कराते हैं. इसमें ऑफ़र डिफ़ॉल्ट रूप से स्वीकार किए जाते हैं, डोमेन की पुष्टि करने की ज़रूरत नहीं होती, और डेटा को कभी भी सार्वजनिक तौर पर नहीं दिखाया जाता.
अपने टेस्ट खाते का इस्तेमाल करके, प्रोडक्शन सेटअप को मिरर करें और माइग्रेशन की प्रोसेस को शुरू से आखिर तक दोहराएं:
- अपने फ़ाइल फ़ीड सेटअप को मिरर करें: टेस्ट खाते में, फ़ाइल वाला प्राइमरी डेटा सोर्स (और कोई भी पूरक डेटा सोर्स) बनाएं. साथ ही, अपनी प्रोडक्शन फ़ीड फ़ाइल का सैंपल अपलोड करें.
- एपीआई डेटा सोर्स और नियमों को टेस्ट करने के लिए बनाएं: एपीआई प्राइमरी डेटा सोर्स बनाएं. साथ ही, एट्रिब्यूट के लिए ज़रूरी नियम या पूरक फ़ीड को जोड़ने की सुविधा कॉन्फ़िगर करें.
- मालिकाना हक लेने और मुख्य अलाइनमेंट की जांच करें: सैंपल प्रॉडक्ट के लिए
productInputs.insertअनुरोध भेजें. साथ ही, पुष्टि करें कि एपीआई डेटा सोर्स, डुप्लीकेट प्रॉडक्ट बनाए बिना मौजूदा आइटम का मालिकाना हक लेता है. - अपडेट और मिटाए गए डेटा की पुष्टि करना:
productInputs.patchका इस्तेमाल करके, कुछ अपडेट की जांच करें औरproductInputs.deleteका इस्तेमाल करके, मिटाए गए डेटा की जांच करें. साथ ही,products.getका इस्तेमाल करके, नतीजे के तौर पर मिले संसाधनों की जांच करें.
2. प्रोडक्शन एपीआई वाले डेटा सोर्स बनाना
डेटा पुश करने से पहले, अपने खाते में एपीआई टाइप का प्राइमरी डेटा सोर्स बनाएं.
एपीआई वाला प्राइमरी डेटा सोर्स बनाना
एपीआई पुश स्वीकार करने वाला डेटा सोर्स बनाने के लिए, dataSources एंडपॉइंट पर POST अनुरोध भेजें. ज़्यादा जानकारी के लिए, प्राइमरी प्रॉडक्ट डेटा सोर्स बनाना लेख पढ़ें.
3. कस्टम एट्रिब्यूट के नियमों को ट्रांज़िशन करना
एट्रिब्यूट के कस्टम नियम, खास डेटा सोर्स से जुड़े होते हैं. ये नियम, फ़ाइल डेटा सोर्स से आपके नए एपीआई डेटा सोर्स में अपने-आप ट्रांसफ़र नहीं होते.
एट्रिब्यूट के नियमों को ट्रांज़िशन करने का तरीका, उनके मकसद पर निर्भर करता है:
- अलग-अलग सोर्स को मर्ज करना और तीसरे पक्ष के पूरक फ़ीड: अगर आपने प्राइमरी एपीआई डेटा को बाहरी पूरक डेटा सोर्स (जैसे, तीसरे पक्ष के सप्लायर की फ़ाइलें, इन्वेंट्री स्प्रेडशीट या प्रमोशन फ़ीड) के साथ जोड़ा है, तो आपको Merchant Center के यूज़र इंटरफ़ेस (यूआई) में एट्रिब्यूट के नियम फिर से बनाने होंगे. साथ ही, उन्हें नए एपीआई डेटा सोर्स से अटैच करना होगा. क्लाइंट-साइड प्री-प्रोसेसिंग, उन नियमों को नहीं बदल सकती जो कई अलग-अलग सोर्स के डेटा को जोड़ते हैं.
- एक सोर्स से मिलने वाले डेटा में बदलाव करना: एक सोर्स से मिलने वाले डेटा को साफ़ करने, डिफ़ॉल्ट वैल्यू सेट करने या अपने प्राइमरी कैटलॉग डेटा पर स्ट्रिंग फ़ॉर्मैटिंग करने के लिए, इनमें से कोई एक विकल्प चुनें:
- बैकएंड ट्रांसफ़ॉर्मेशन (सुझाया गया): एपीआई को कॉल करने से पहले, अपने सिस्टम में ट्रांसफ़ॉर्मेशन लागू करें. इससे आपको प्रोग्राम के हिसाब से ज़्यादा कंट्रोल, आसान टेस्टिंग, और डीबग करने की सुविधा मिलती है.
- Merchant Center में एट्रिब्यूट के नियम: अगर आपको Merchant Center से अपने-आप मैनेज होने की सुविधा जारी रखनी है, तो Merchant Center के यूज़र इंटरफ़ेस (यूआई) में जाकर, अपने नए एपीआई डेटा सोर्स के लिए, बदलाव करने के नियम फिर से बनाएं.
4. एपीआई इंटिग्रेशन की सुविधा चालू करना
अपने नए एपीआई प्राइमरी डेटा सोर्स में प्रॉडक्ट डालने, अपडेट करने, और मिटाने के लिए, प्रोडक्शन एपीआई इंटिग्रेशन को चालू करें:
प्रॉडक्ट जोड़ना और अपडेट करना (मालिकाना हक लेना): अपने इंटिग्रेशन से
productInputs.insertऔरproductInputs.patchअनुरोध भेजें. जब एपीआई का इस्तेमाल करके, किसी प्रॉडक्ट को उसी कुंजी (offerId,contentLanguage,feedLabel) के साथ डाला जाता है जो फ़ाइल फ़ीड में मौजूद किसी प्रॉडक्ट की है, तो एपीआई डेटा सोर्स उस प्रॉडक्ट का मालिकाना हक ले लेता है. साथ ही, उसके विज्ञापन दिखाने का इतिहास सुरक्षित रखता है. ज़्यादा जानकारी के लिए, प्रॉडक्ट जोड़ना और प्रॉडक्ट जोड़ना और मैनेज करना लेख पढ़ें.बंद किए गए प्रॉडक्ट मिटाना: अपने इंटिग्रेशन को इस तरह कॉन्फ़िगर करें कि जब भी आपके कैटलॉग से कोई प्रॉडक्ट हटाया जाए, तो वह
productInputs.deleteको कॉल करे.धीरे-धीरे डिप्लॉय करें: बड़े कैटलॉग के लिए, इंटिग्रेशन को एक बार में Merchant Center के एक उप-खाते या एक डेटा सोर्स के लिए चालू करें.
एक साथ कई अनुरोधों को मैनेज करने की सुविधा कॉन्फ़िगर करें: अगर आपको कई अनुरोध भेजने हैं, तो अपने क्लाइंट को एक साथ कई अनुरोधों को मैनेज करने और कई कनेक्शन मैनेज करने के लिए कॉन्फ़िगर करें. एक साथ कई अनुरोध करने के लिए कोड को फिर से व्यवस्थित करना गाइड देखें.
5. फ़ाइल डेटा सोर्स के अपडेट रोकना
एपीआई इंटिग्रेशन चालू होने के बाद, फ़ाइल के अगले शेड्यूल किए गए रन से पहले, फ़ाइल के अपडेट बंद कर दें. इससे फ़ाइल डेटा सोर्स, आपके एपीआई अपडेट को ओवरराइट नहीं करेगा:
- अपने एसएफ़टीपी/एफ़टीपी लोकेशन, Google Cloud Storage या Google Sheets में नई फ़ाइलें अपलोड करना बंद करें.
- Merchant Center के यूज़र इंटरफ़ेस (यूआई) में, अपने फ़ाइल डेटा सोर्स पर जाएं और फ़ीड पाने के शेड्यूल को रोकें.
- फ़ाइल डेटा सोर्स में मौजूद प्रॉडक्ट, 30 दिनों तक लाइव रहते हैं. इसके बाद, एपीआई इंटिग्रेशन उन्हें हटा देता है.
6. माइग्रेशन पूरा होने और पुष्टि होने का इंतज़ार करें
सभी चालू प्रॉडक्ट, फ़ाइल डेटा सोर्स से एपीआई डेटा सोर्स में माइग्रेट होने तक इंतज़ार करें. इंक्रीमेंटल अपडेट, प्रॉडक्ट में बदलाव होने पर उन्हें माइग्रेट करते हैं. हालांकि, अपने रेगुलर इंटिग्रेशन की मदद से, पूरे कैटलॉग को सिंक करने की प्रोसेस को धीरे-धीरे चलाने से, आपके पूरे कैटलॉग को माइग्रेट करने की प्रोसेस तेज़ हो जाती है. इस बारे में ज़्यादा जानने के लिए, सिंक करने की रणनीति और कोटा देखें.
इस दौरान:
- Merchant Center के यूज़र इंटरफ़ेस (यूआई) में, आइटम की संख्या पर नज़र रखें. फ़ाइल डेटा सोर्स की संख्या
0होने तक इंतज़ार करें. साथ ही, एपीआई डेटा सोर्स की संख्या आपके चालू कैटलॉग से मैच होने तक इंतज़ार करें. products.getका इस्तेमाल करके, पुष्टि करें कि एट्रिब्यूट और कस्टम एट्रिब्यूट के नियम, उम्मीद के मुताबिक मर्ज हो रहे हैं.- गड़बड़ी की दर और एपीआई की परफ़ॉर्मेंस को ट्रैक करने के लिए, Merchant Center के यूज़र इंटरफ़ेस (यूआई) में एपीआई डाइग्नोस्टिक्स टूल को मॉनिटर करें.
7. फ़ाइल डेटा सोर्स को बंद करना
ट्रांसफ़र पूरा होने और फ़ाइल फ़ीड आइटम की संख्या 0 होने के बाद:
- पुष्टि करें कि अपडेट रीयल-टाइम में दिख रहे हैं.
- Merchant Center के यूज़र इंटरफ़ेस (यूआई) में जाकर, लेगसी फ़ाइल डेटा सोर्स को मिटाएं. इससे, फ़ाइल के आधार पर होने वाले अपडेट, आपके एपीआई डेटा को गलती से ओवरराइट नहीं कर पाएंगे.