Merchant Products API के बारे में खास जानकारी

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

Merchant Center के प्रॉडक्ट एपीआई में दो संसाधन होते हैं.

• productInputs, आपके प्रॉडक्ट के इनपुट पार्ट दिखाता है.
• products, प्रोसेस किए गए उन प्रॉडक्ट को दिखाता है जिन्हें आपके इनपुट पार्ट्स से बनाया गया है.

productInputs को प्राइमरी और सप्लीमेंटरी, दोनों तरह का डेटा माना जा सकता है. यह इस बात पर निर्भर करता है कि इसे प्राइमरी डेटा सोर्स या सप्लीमेंटल डेटा सोर्स में अपलोड किया गया है. हर product को एक प्राइमरी productInput और किसी भी संख्या में पूरक productInputs से बनाया जाएगा.

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

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

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

अगर आपके पास कोई डेटा सोर्स नहीं है, तो Merchant DataSources API या Merchant Center का इस्तेमाल करके डेटा सोर्स बनाएं.

अगर आपके पास पहले से कोई डेटा सोर्स है, जिसे आपने Merchant Center के यूज़र इंटरफ़ेस (यूआई) या एपीआई का इस्तेमाल करके बनाया है, तो अपने प्रॉडक्ट जोड़ने के लिए Merchant Center के प्रॉडक्ट एपीआई का इस्तेमाल किया जा सकता है. अगर प्रॉडक्ट जोड़ने के लिए Content API for Shopping का इस्तेमाल किया जा रहा है, तो Merchant Product API का इस्तेमाल शुरू करने का तरीका समझने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.

शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग की नीतियों का पालन करना आपकी ज़िम्मेदारी है. शॉपिंग विज्ञापनों के लिए बनी इन नीतियों को लागू करने का अधिकार, Shopping Ads के पास सुरक्षित है. साथ ही, अगर हमें इन नीतियों का उल्लंघन करने वाला कॉन्टेंट या व्यवहार मिलता है, तो हम ज़रूरत के हिसाब से कार्रवाई करेंगे.

संसाधन

products संसाधन की मदद से, Shopping डेटाबेस से प्रॉडक्ट की जानकारी हासिल की जा सकती है.

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

• channel: प्रॉडक्ट का चैनल.
• offerId: प्रॉडक्ट का यूनीक आइडेंटिफ़ायर.
• contentLanguage: प्रॉडक्ट के लिए, दो अक्षरों वाला ISO 639-1 भाषा कोड.
• feedLabel: प्रॉडक्ट के लिए फ़ीड का लेबल.

अपने खाते में प्रॉडक्ट इनपुट अपलोड करना

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

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

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE}

{
  "name": "{PRODUCT_TITLE}",
  "versionNumber": {VERSION_NUMBER},
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "offerId": "{OFFER_ID}",
  "channel": "ONLINE",
  "attributes": {
    "availability": "in stock",
    "imageLink": "{IMAGE_LINK}",
    "link": "{PRODUCT_LINK}",
    "brand": "{BRAND_NAME}",
    "price": {
      "currencyCode": "{CURRENCY_CODE}",
      "amountMicros": {PRICE}
    },
    "color": "red",
    "productWeight": {
      "value": 320,
      "unit": "g"
    },
    "adult": false,
    "shipping": [
      {
        "country": "GB",
        "price": {
          "amountMicros": {SHIPPING_COST},
          "currencyCode": "{CURRENCY_CODE_SHIPPING}"
        },
        "postalCode": "{SHIPPING_POSTALCODE}",
        "service": "",
        "region": "{SHIPPING_REGION}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}"
      }
    ],
    "gender": "Female"
  },
  "customAttributes": [
    {
      "name": "size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

इनकी जगह ये डालें:

• {ACCOUNT_ID}: आपके Merchant Center खाते का यूनीक आइडेंटिफ़ायर.
• {DATASOURCE}: डेटा सोर्स का यूनीक आइडेंटिफ़ायर. यह accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} फ़ॉर्मैट में होना चाहिए.
• {PRODUCT_TITLE}: प्रॉडक्ट का नाम.
• {VERSION_NUMBER}: प्रॉडक्ट का वर्शन नंबर. ज़रूरी नहीं.
• {CONTENT_LANGUAGE}: प्रॉडक्ट के लिए, दो अक्षरों वाला ISO 639-1 भाषा कोड. ज़रूरी है.
• {FEED_LABEL}: उस इलाके के लिए CLDR इलाके का कोड जहां आपको प्रॉडक्ट बेचना है. अगर feedLabel के लिए दी गई वैल्यू अमान्य है, तो targetCountry फ़ील्ड में अपने-आप कोई जानकारी नहीं भरती.
• {OFFER_ID}: प्रॉडक्ट का यूनीक आइडेंटिफ़ायर. ज़रूरी है.
• {IMAGE_LINK}: आपकी वेबसाइट पर मौजूद प्रॉडक्ट की इमेज का लिंक. ज़रूरी नहीं.
• {PRODUCT_LINK}: आपकी वेबसाइट पर मौजूद प्रॉडक्ट का लिंक. ज़रूरी नहीं.
• {CURRENCY_CODE}: ISO 4217 के मुताबिक, तीन अक्षरों वाले संक्षिप्त नाम का इस्तेमाल करके कीमत की मुद्रा. ज़रूरी नहीं.
• {PRICE}: प्रॉडक्ट की कीमत, माइक्रो में संख्या के तौर पर दिखाई जाती है. ज़रूरी नहीं.
• {SHIPPING_COST}: शिपिंग के लिए तय की गई कीमत, संख्या के तौर पर दिखाई जाती है. ज़रूरी नहीं.
• {SHIPPING_POSTALCODE}: पिन कोड की वह रेंज जहां शिपिंग की दर लागू होती है. ज़रूरी नहीं.
• {MAX_HANDLING_TIME}: ऑर्डर मिलने और उसे शिप करने के बीच, कामकाजी दिनों में लगने वाला ज़्यादा से ज़्यादा समय. ज़रूरी नहीं.
• {MIN_HANDLING_TIME}: ऑर्डर मिलने और उसे शिप करने के बीच, कामकाजी दिनों में लगने वाला कम से कम समय. वैल्यू 0 का मतलब है कि ऑर्डर मिलने के दिन ही डिलीवर कर दिया जाता है. ज़रूरी नहीं.
• {MAX_TRANSIT_TIME}: ऑर्डर भेजे जाने और डिलीवर होने के बीच, कामकाजी दिनों में लगने वाला ज़्यादा से ज़्यादा समय. ज़रूरी नहीं.
• {MIN_TRANSIT_TIME}: ऑर्डर भेजने और डिलीवर होने के बीच, कामकाजी दिनों में लगने वाला कम से कम ट्रांज़िट समय. वैल्यू 0 का मतलब है कि ऑर्डर शिप होने के दिन ही डिलीवर हो जाता है. ज़रूरी नहीं.

अनुरोध पूरा होने पर, आपको यह जवाब दिखता है:

{
  "name": "{PRODUCT_NAME}",
  "product": "{PRODUCT_ID}",
  "channel": "ONLINE",
  "offerId": "{OFFER_ID}",
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "versionNumber": "{VERSION_NUMBER}",
  "attributes": {
    "link": "{PRODUCT_LINK}",
    "imageLink": "{IMAGE_LINK}",
    "adult": false,
    "availability": "in stock",
    "brand": "{BRAND_NAME}",
    "color": "red",
    "gender": "Female",
    "price": {
      "amountMicros": "{PRICE}",
      "currencyCode": "{CURRENCY_CODE}"
    },
    "shipping": [
      {
        "price": {
          "amountMicros": "{SHIPPING_COST}",
          "currencyCode": "{CURRENCY_CODE}"
        },
        "country": "{SHIPPING_COUNTRY}",
        "region": "{SHIPPING_REGION}",
        "postalCode": "{SHIPPING_POSTALCODE}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}"
      }
    ],
    "productWeight": {
      "value": 320,
      "unit": "g"
    }
  },
  "customAttributes": [
    {
      "name": "Size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

अपने खाते से प्रोसेस किए गए प्रॉडक्ट को वापस पाना

अपने खाते से प्रोसेस किए गए प्रॉडक्ट को वापस पाने के लिए, accounts.products.get तरीका अपनाएं. प्रॉडक्ट डालने के बाद, प्रोसेस किए गए प्रॉडक्ट को दिखने में कुछ मिनट लग सकते हैं.

प्रोसेस किए गए प्रॉडक्ट का नाम, accounts.productInputs.insert के रिस्पॉन्स में मौजूदproduct फ़ील्ड से पाया जा सकता है

अपने खाते से प्रॉडक्ट इनपुट मिटाना

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

अपने खाते के प्रॉडक्ट की लिस्टिंग बनाना

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