Content API के साथ पूरक फ़ीड का इस्तेमाल करना

आप प्रॉडक्ट डेटा में कुछ बदलाव करने के लिए, पूरक फ़ीड का इस्तेमाल कर सकते हैं. इसके लिए, feedId को क्वेरी पैरामीटर के रूप में products.insert, products.delete, products.custombatch.insert, और products.custombatch.delete तरीकों का इस्तेमाल करना होगा.

उदाहरण के लिए, products.insert पूरक फ़ीड के तरीके की मदद से इन्हें कॉल किया जा सकता है: नीचे दिया गया यूआरएल:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

products.insert

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

पूरक फ़ीड का अनुरोध करने के लिए, इस यूआरएल का इस्तेमाल करें Product.insert सेवा:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

आपको offerId, feedLabel, channel, और अनुरोध के मुख्य हिस्से में contentLanguage फ़ील्ड हैं. अन्य सभी फ़ील्ड ज़रूरी नहीं हैं.

उदाहरण

किसी प्रॉडक्ट की खरीदारी के लिए उपलब्धता को “स्टॉक में है” से “स्टॉक में नहीं है” में बदलने के लिए, आपको पूरक फ़ीड बनाने के लिए, इस अनुरोध के मुख्य हिस्से का इस्तेमाल कर सकता है Product.insert तरीका कॉल:

{
 "offerId": "1111111111",
 "contentLanguage": "en",
 "feedLabel": "US",
 "channel": "online",
 "availability": "out of stock",
}

products.delete

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

पूरक फ़ीड का अनुरोध करने के लिए, इस यूआरएल का इस्तेमाल करें products.delete सेवा में शामिल हो जाता है, जहां productId REST आईडी प्रॉडक्ट का हिस्सा है, जो इस तरह दिखाया जाता है: channel:contentLanguage:feedLabel:offerId:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

पूरक फ़ीड products.delete तरीके के कॉल के लिए, अनुरोध के किसी मुख्य हिस्से की ज़रूरत नहीं होती.

products.custombatch

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

custombatch कॉल करने के लिए, इस अनुरोध के यूआरएल का इस्तेमाल करें:

https://shoppingcontent.googleapis.com/content/v2.1/products/batch

सभी पूरक फ़ीड custombatch कॉल के लिए, आपको batchId, अनुरोध में merchantID, method, और feedId पैरामीटर शामिल हैं शरीर.

products.custombatch:insert

products.custombatch:insert तरीके का इस्तेमाल करके पूरक फ़ीड का इस्तेमाल करते समय, आपको offerId, feedLabel, channel, और अनुरोध के मुख्य हिस्से में, ज़रूरी batchId के अलावा, contentLanguage merchantID और method पैरामीटर. बाकी सभी प्रॉडक्ट फ़ील्ड ज़रूरी नहीं हैं.

उदाहरण

दो मौजूदा प्रॉडक्ट की price वैल्यू अपडेट करने के लिए, इसका इस्तेमाल किया जा सकता है products.custombatch:insert विधि कॉल करने के अनुरोध का अनुसरण कर रहा है:.

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "1111111111",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "30.99",
          "currency": "USD"
         }
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "2222222222",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "33.99",
          "currency": "USD"
         },
      },
    }
}

products.custombatch:delete

किसी बताए गए पूरक फ़ीड के ज़रिए दो प्रॉडक्ट में किए गए सभी अपडेट हटाने के लिए, products.custombatch:delete बनाने के लिए, नीचे दिए गए अनुरोध का इस्तेमाल करें तरीका कॉल:

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:2222222222"
    }
  ]
}