प्रॉडक्ट संसाधन कॉल

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

products संसाधन की मदद से, एक बार में एक प्रॉडक्ट को insert, get, update और delete किया जा सकता है. साथ ही, Merchant Center के डेटाबेस में मौजूद list सभी प्रॉडक्ट को भी ऐसा किया जा सकता है.

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

एपीआई के उदाहरणों में, हमने तीन प्रॉडक्ट इस्तेमाल किए हैं: दो Google टी-शर्ट और एक Google कैप. हमने नीचे दी गई टेबल में दिखाए गए प्रॉडक्ट डेटा के छोटे सेट का इस्तेमाल किया है. इससे, अलग-अलग प्रॉडक्ट और प्रॉडक्ट के बैच को डालने, पाने, अपडेट करने, लिस्ट करने, और मिटाने के लिए products रिसॉर्स कॉल किए जा सकते हैं.

हमारा सुझाव है कि शिपिंग और टैक्स की जानकारी को प्रॉडक्ट लेवल के बजाय खाता लेवल पर कॉन्फ़िगर किया जाए.

मार्केटप्लेस के मल्टी-सेलर वाले उप-खातों के लिए, सभी प्रॉडक्ट में external_seller_id फ़ील्ड शामिल होना चाहिए. ज़्यादा जानकारी के लिए, प्रॉडक्ट आईडी देखें.

आईडी online:en:US:1111111111 online:en:US:2222222222 online:en:US:3333333333
offerId 1111111111 2222222222 3333333333
title ब्लैक Google टी-शर्ट Google Tee Green Google Twill Cap
ब्यौरा ब्लैक Google टी-शर्ट Google की 100% कॉटन वाली टी-शर्ट Google का क्लासिक कैप
सामान के ग्रुप का आईडी google_tee google_tee
लिंक http://my.site.com/blacktee http://my.site.com/greentee http://my.site.com/blackhat
शर्त नई सुविधा नई सुविधा नई सुविधा
कीमत 2,199 रुपये 2,199 रुपये 1,099 रुपये
उपलब्धता स्टॉक में है स्टॉक में है स्टॉक में है
imageLink https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
GTIN 9504000059422 9504000059446 9504000059452
एमपीएन 00638NIC 00638ANG 00638ABC
ब्रैंड Google Google Google
Google प्रॉडक्ट कैटगरी Apparel & Accessories > Clothing Apparel & Accessories > Clothing Apparel & Accessories > Clothing Accessories > Hats
रंग ब्लैक ग्रीन ब्लैक
साइज़ L M M
age_group वयस्क वयस्क वयस्क
लिंग पुरुष पुरुष unisex
included_destination Shopping Actions, शॉपिंग विज्ञापन Shopping Actions, शॉपिंग विज्ञापन 'शॉपिंग' कार्रवाइयां

products.insert

एक प्रॉडक्ट डालने के लिए, यहां दिए गए अनुरोध वाले यूआरएल का इस्तेमाल करें. इसमें अपना कारोबारी या कंपनी का आईडी और JSON बॉडी का सैंपल डालें. insert से नया प्रॉडक्ट बनता है. अगर किसी प्रॉडक्ट के लिए, channel, contentLanguage, offerId, और feedLabel एट्रिब्यूट की वैल्यू मौजूद हैं, तो यह तरीका उस एंट्री को अपडेट करता है. साथ ही, दिए गए प्रॉडक्ट के लिए, एपीआई के पिछले सभी कॉल से मिले डेटा को बदल देता है.

वे प्रॉडक्ट अपने-आप मिट जाते हैं जिन्हें सात से ज़्यादा दिन तक सभी डेस्टिनेशन से बाहर रखा जाता है.

यहां दिए गए उदाहरण में, उपलब्ध प्रॉडक्ट में एक नया प्रॉडक्ट "Black Google Tee" जोड़ा गया है.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

products.insert के लिए अनुरोध के मुख्य हिस्से का उदाहरण:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

किसी प्रॉडक्ट के लिए, JSON बॉडी में कस्टम एट्रिब्यूट भी सेट किए जा सकते हैं. उदाहरण के लिए, हम किसी एक प्रॉडक्ट के लिए purchase_quantity_limit सेट कर सकते हैं, ताकि यह तय किया जा सके कि कोई खरीदार ज़्यादा से ज़्यादा कितने आइटम ऑर्डर कर सकता है:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

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

कॉल पूरा होने पर, HTTP 200 कोड और जवाब का मुख्य हिस्सा मिलता है. इसमें सिर्फ़ id, offerId, contentLanguage, feedLabel, और channel प्रॉपर्टी के साथ डाला गया प्रॉडक्ट रिसॉर्स होता है:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

Merchant Center के डेटाबेस में मौजूद किसी प्रॉडक्ट के बारे में जानकारी पाने के लिए, products.get का इस्तेमाल करें. नया प्रॉडक्ट डालने के बाद, उसे इस कॉल के ज़रिए उपलब्ध होने में कुछ मिनट लग सकते हैं.

आपको जिस प्रॉडक्ट की जानकारी चाहिए उसके लिए, यहां दिए गए एचटीटीपी अनुरोध यूआरएल और पैरामीटर, कारोबारी या कंपनी का आईडी, और प्रॉडक्ट आईडी (REST आईडी फ़ॉर्मैट) का इस्तेमाल करें:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

कॉल पूरा होने पर, जवाब के मुख्य हिस्से में HTTP 200 और "प्रॉडक्ट रिसॉर्स" दिखता है. यहां आईडी online:en:US:1111111111 वाले प्रॉडक्ट से मिला सैंपल प्रॉडक्ट डेटा दिया गया है:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

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

किसी एट्रिब्यूट को जोड़ने या उसमें बदलाव करने के लिए, JSON बॉडी में नई वैल्यू के साथ फ़ील्ड तय करें. यहां दिखाए गए उदाहरण में, अनुरोध के मुख्य हिस्से में दिए गए प्रॉडक्ट डेटा की मदद से, मौजूदा "ब्लैक Google टी-शर्ट" के title और description को अपडेट किया जाएगा. साथ ही, अन्य सभी फ़ील्ड में कोई बदलाव नहीं किया जाएगा.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

products.update के लिए अनुरोध के मुख्य हिस्से का उदाहरण:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

products.update अनुरोध के ज़रिए, सिर्फ़ टॉप-लेवल फ़ील्ड अपडेट किए जा सकते हैं. अगर आपको नेस्ट किए गए फ़ील्ड अपडेट करने हैं, तो आपको पूरा टॉप-लेवल ऑब्जेक्ट देना होगा.

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

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

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

दिखाया गया उदाहरण, "Black Google Tee" के description और availability को सिर्फ़ अपडेट करेगा. इसके लिए, अनुरोध के मुख्य हिस्से में दिए गए प्रॉडक्ट डेटा का इस्तेमाल किया जाएगा. इससे title सहित अन्य सभी फ़ील्ड में कोई बदलाव नहीं होगा.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

products.update के लिए अनुरोध के मुख्य हिस्से का उदाहरण:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

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

यहां दिए गए उदाहरण में, salePrice फ़ील्ड की वैल्यू हटाने के लिए updateMask का इस्तेमाल किया जाएगा.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

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

products.custombatch अनुरोध में updateMask का इस्तेमाल करने के लिए, अनुरोध के मुख्य हिस्से में updateMask की जानकारी दी जानी चाहिए.

यहां दिखाए गए उदाहरण में, बैच एंट्री में दिए गए प्रॉडक्ट डेटा के साथ products.custombatch का इस्तेमाल करके, मौजूदा "ब्लैक Google टी-शर्ट" के price और availability को अपडेट किया जाएगा. साथ ही, title और description सहित अन्य सभी फ़ील्ड में कोई बदलाव नहीं किया जाएगा.

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

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

किसी एक प्रॉडक्ट को मिटाने के लिए, products.delete का इस्तेमाल करें. इसके साथ, एचटीटीपी अनुरोध का सैंपल यूआरएल, कारोबारी या कंपनी का आईडी, और उस प्रॉडक्ट का आईडी (REST आईडी फ़ॉर्मैट में, जैसे कि online:en:US:1111111111) इस्तेमाल करें जिसे आपको मिटाना है:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

अनुरोध पूरा होने पर, जवाब के तौर पर HTTP Status 204 मिलता है. इसमें कोई जवाब नहीं होता.

products.list

products.list में, वे सभी प्रॉडक्ट शामिल होते हैं जो कारोबारी या कंपनी के Merchant Center डेटाबेस में मौजूद हैं. अनुरोध के लिए इस यूआरएल का इस्तेमाल करें:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

सफल कॉल पर, "resources" कुंजी में मौजूद प्रॉडक्ट के लिए HTTP 200 और JSON डेटा मिलता है.

यहां तीन उदाहरण प्रॉडक्ट दिखाए गए हैं:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}
पीछे जाएं
प्रॉडक्ट ID
आगे बढ़ें
बैच मोड