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

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

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

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

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

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

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

आईडी online:en:US:1111111111 online:en:US:2222222222 online:en:US:3333333333
offerId 1111111111 2222222222 3333333333
title The Black Google Tee Google Tee Green Google Twill Cap
ब्यौरा The Black Google Tee 100% cotton Google t-shirt Classic Google cap
सामान के ग्रुप का आईडी 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, शॉपिंग विज्ञापन Shopping Actions

products.insert

कोई एक प्रॉडक्ट जोड़ने के लिए, अनुरोध का यह यूआरएल इस्तेमाल करें. इसमें, अपना Merchant ID और 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 का इस्तेमाल करें. हाल ही में जोड़े गए प्रॉडक्ट की जानकारी, इस कॉल के ज़रिए मिलने में कुछ मिनट लग सकते हैं.

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

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

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

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

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

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 का इस्तेमाल करें. इसके लिए, अनुरोध का यह एचटीटीपी यूआरएल, अपना Merchant ID, और उस प्रॉडक्ट का आईडी (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 और "resources" कुंजी में प्रॉडक्ट का 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
आगे बढ़ें
बैच मोड