व्यापारी/कंपनी/कारोबारी के डेटा सोर्स एपीआई की खास जानकारी

इस पेज पर, प्रोग्राम के हिसाब से डेटा सोर्स बनाने और उन्हें अपडेट करने का तरीका बताया गया है. इन डेटा सोर्स की मदद से, प्रॉडक्ट डाले जा सकते हैं. ऑटोमेटेड डेटा सोर्स के हिसाब से, डेटा भेजने की प्रोसेस को आसान बनाया जाता है Google को अपना प्रॉडक्ट डेटा भेज सकते हैं. अपने-आप जनरेट होने वाले डेटा सोर्स से यह पक्का किया जाता है कि आपकी वेबसाइट के काम के प्रॉडक्ट के बारे में अप-टू-डेट जानकारी Google तक पहुंचती है.

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

Content API for Shopping की मदद से, सिर्फ़ फ़ाइल इनपुट वाले डेटा सोर्स मैनेज किए जा सकते हैं. Merchant API की मदद से, फ़ाइल और एपीआई इनपुट, दोनों के साथ डेटा सोर्स मैनेज किए जा सकते हैं.

Merchant Center के डेटा सोर्स के एपीआई का इस्तेमाल करके, ये काम किए जा सकते हैं:

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

Merchant API का इस्तेमाल करके, ऐसे डेटा सोर्स में प्रॉडक्ट नहीं डाले जा सकते जिसमें स्थानीय और ऑनलाइन, दोनों तरह के प्रॉडक्ट शामिल हों. डेटा सोर्स चैनलों के बारे में ज़्यादा जानकारी के लिए, चैनल देखें.

ज़रूरी शर्तें

  • आपका खाता, एक ही स्थानीय भाषा वाले फ़ीड पर माइग्रेट हो गया हो.

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

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

कोई नया डेटा सोर्स बनाना

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

किसी खास feedLabel के साथ नया प्राइमरी डेटा सोर्स बनाने और contentLanguage, feedLabel और contentLanguage फ़ील्ड को इसमें सेट करें टाइप के हिसाब से कॉन्फ़िगरेशन. इन फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, PrimaryProductDataSource देखें.

डेटा सोर्स बनाने के बारे में ज़्यादा जानने के लिए, accounts.dataSources.create तरीका.

नया डेटा सोर्स देखने के लिए, accounts.dataSources.get या accounts.dataSources.list तरीका.

एक नया प्राइमरी डेटा सोर्स बनाना, जिससे कई देशों को टारगेट करने में मदद मिलती है

एक से ज़्यादा देशों को टारगेट करने में मदद करने वाला नया प्राइमरी फ़ीड बनाने के लिए, PrimaryProductDataSource का इस्तेमाल करके अपने डेटा सोर्स को कॉन्फ़िगर करें. साथ ही, feedLabel और contentLanguage फ़ील्ड सेट न करें.

Content API for Shopping का इस्तेमाल करने पर, आपके लिए सिर्फ़ एक एपीआई डेटा सोर्स बनाया जाता है. Merchant Data Source API का इस्तेमाल करके, आपके पास एक से ज़्यादा एपीआई डेटा सोर्स हो सकते हैं. इनमें से कुछ फ़ील्ड को feedLabel और contentLanguage फ़ील्ड सेट के बिना भी सेट किया जा सकता है.

एपीआई इनपुट वाले डेटा सोर्स के लिए ही feedLabel और contentLanguage फ़ील्ड सेट किए बिना काम किया जा सकता है. इस तरह के डेटा सोर्स, फ़ाइल के साथ काम नहीं करते इनपुट.

कोई पूरक डेटा सोर्स बनाएं और उसे प्राइमरी डेटा सोर्स से लिंक करें

पूरक डेटा सोर्स का इस्तेमाल सिर्फ़ उस प्रॉडक्ट डेटा को अपडेट करने के लिए किया जाता है जो एक या एक से ज़्यादा प्राइमरी डेटा सोर्स में पहले से मौजूद होता है. आपके पास एक से ज़्यादा सप्लीमेंट हो सकते हैं डेटा सोर्स शामिल किए जा सकते हैं. साथ ही, हर डेटा सोर्स को कई तरह के प्राइमरी डेटा को शामिल करने में मदद मिलती है. स्रोत.

प्रॉडक्ट डेटा में कुछ बदलाव करने के लिए, पूरक डेटा सोर्स का इस्तेमाल किया जा सकता है. इसके लिए, ये काम किए जा सकते हैं: डेटा सोर्स का यूनीक आइडेंटिफ़ायर, क्वेरी पैरामीटर के तौर पर जोड़ते समय CANNOT TRANSLATE accounts.productInputs.insert और accounts.productInputs.delete तरीकों का इस्तेमाल करना होगा. मौजूदा प्रॉडक्ट को अपडेट करने के लिए, सिर्फ़ पूरक डेटा सोर्स का इस्तेमाल किया जा सकता है.

पूरक डेटा सोर्स बनाने के लिए, SupplementalProductDataSource का इस्तेमाल करके अपने डेटा सोर्स को कॉन्फ़िगर करें. इसके बाद, अपने प्राइमरी डेटा सोर्स पर defaultRule फ़ील्ड को अपडेट करके, उसे लिंक करें.

पूरक फ़ाइल के डेटा सोर्स में, feedLabel और contentLanguage शामिल होने चाहिए फ़ील्ड सेट नहीं हैं. पूरक एपीआई डेटा सोर्स में हमेशा feedLabel और contentLanguage फ़ील्ड सेट नहीं किए गए.

फ़ाइल डेटा सोर्स के लिए शेड्यूल सेट अप करना

अपने फ़ाइल फ़ीड के लिए शेड्यूल सेट अप करने के लिए, FileInput फ़ील्ड का इस्तेमाल करके अपने डेटा सोर्स को फ़ाइल डेटा सोर्स के तौर पर कॉन्फ़िगर करें. इसके बाद, FileInput.FetchSettings फ़ील्ड का इस्तेमाल करके fetchsettings सेट अप करें.

कोई डेटा सोर्स मिटाना

अपने खाते से कोई मौजूदा डेटा सोर्स मिटाने के लिए, accounts.dataSources.delete तरीका.

डेटा सोर्स फ़ेच करना

डेटा सोर्स में कॉन्फ़िगर की गई फ़ाइल को फ़ेच करने के लिए, accounts.dataSources.fetch तरीका. इस तरीके से, आपके खाते के डेटा सोर्स से तुरंत डेटा फ़ेच किया जाता है. यह तरीका सिर्फ़ उन डेटा सोर्स पर काम करता है जिनमें फ़ाइल इनपुट सेट होता है.

डेटा सोर्स पाना

अपने खाते का डेटा सोर्स कॉन्फ़िगरेशन पाने के लिए, accounts.dataSources.get तरीका.

डेटा सोर्स की सूची

अपने खाते के डेटा सोर्स के कॉन्फ़िगरेशन को सूची में शामिल करने के लिए, accounts.dataSources.list तरीका.

पैच डेटा सोर्स

किसी मौजूदा डेटा सोर्स के कॉन्फ़िगरेशन को अपडेट करने के लिए, accounts.dataSources.patch वाला तरीका अपनाएं.

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

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

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

फ़ीड अपने-आप मैनेज होना

डेटा सोर्स को अपने-आप मैनेज करने की सुविधा के लिए, अपने खाते को रजिस्टर करने के लिए, आपको ये काम करने होंगे:

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

फ़ाइल अपलोड होने की स्थिति का पता लगाएं

फ़ाइल, फ़ेच या स्प्रेडशीट वाले डेटा सोर्स का स्टेटस पाने के लिए, accounts.dataSources.fileUploads सेवा के GET तरीके को कॉल किया जा सकता है. डेटा सोर्स प्रोसेस होने के बाद, डेटा सोर्स को फिर से ऐक्सेस करने पर, डेटा सोर्स के आखिरी नतीजे का पता लगाने के लिए, नाम आइडेंटिफ़ायर latest का इस्तेमाल करें.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

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

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