इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

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


id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
टाइटल	ब्लैक Google टी	Google टी ग्रीन	Google ट्विल कैप
ब्यौरा	ब्लैक Google टी	100% कॉटन वाली Google टी-शर्ट	क्लासिक 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	00638एबीसी
ब्रैंड	Google	Google	Google
Google प्रॉडक्ट कैटगरी	कपड़े और ऐक्सेसरी > कपड़े	कपड़े और ऐक्सेसरी > कपड़े	कपड़े और ऐक्सेसरी > कपड़ों की ऐक्सेसरी > टोपी
रंग	काला	हरा	काला
साइज़	L	सोम	सोम
age_group	वयस्क	वयस्क	वयस्क
gender	पुरुष	पुरुष	Unisex
included_destination	Shopping Actions, शॉपिंग विज्ञापन	Shopping Actions, शॉपिंग विज्ञापन	'शॉपिंग' कार्रवाइयां

products.insert

किसी एक प्रॉडक्ट को डालने के लिए, अनुरोध वाले इस यूआरएल का इस्तेमाल करें. इसमें अपना मर्चेंट आईडी और JSON बॉडी का सैंपल दें. डालने से नया प्रॉडक्ट बनता है. अगर दिए गए प्रॉडक्ट के लिए 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 कस्टम एट्रिब्यूट, प्रॉडक्ट डेफ़िनिशन के लिए, ग्राहक के हर ऑर्डर के लिए खरीदारी की सीमा तय करता है. साथ ही, इसका इस्तेमाल फ़ीड के साथ भी किया जा सकता है. फ़िलहाल, यह एट्रिब्यूट बीटा वर्शन में है, जब तक कि एपीआई पूरी तरह से काम नहीं करता. कोई कारोबारी, कोई भी अतिरिक्त कस्टम एट्रिब्यूट जोड़ सकता है. हालांकि, एपीआई की मदद से इसे किसी खास तौर पर प्रोसेस नहीं किया जाता.

कॉल जनरेट होने पर, 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

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

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

किसी एट्रिब्यूट को जोड़ने या उसमें बदलाव करने के लिए, JSON के मुख्य भाग में नई वैल्यू वाली फ़ील्ड की जानकारी दें. दिखाए गए उदाहरण में, मौजूदा "Black Google Tee" के 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 तय न करना, अनुरोध के सभी फ़ील्ड को अपडेट करने के बराबर है जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है.

दिखाए गए उदाहरण में, "ब्लैक Google टी" सुविधा के सिर्फ़ 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 का इस्तेमाल करके, मौजूदा "Black Google Tee" के 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

कॉल पूरी होने पर, "संसाधन" कुंजी में मौजूद प्रॉडक्ट का 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"
   ]
  }
 ]
}