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

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 टी ग्रीन 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 00638ABC
ब्रैंड Google Google Google
Google प्रॉडक्ट कैटगरी कपड़े और ऐक्सेसरी > कपड़े कपड़े और ऐक्सेसरी > कपड़े कपड़े और ऐक्सेसरी > कपड़े की ऐक्सेसरी > टोपी
रंग काला हरा काला
साइज़ L सोम सोम
age_group वयस्क वयस्क वयस्क
gender पुरुष पुरुष उभयलिंगी
included_destination Shopping Actions, शॉपिंग विज्ञापन Shopping Actions, शॉपिंग विज्ञापन 'शॉपिंग' कार्रवाइयां

products.insert

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

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

दिखाए गए उदाहरण में, उपलब्ध प्रॉडक्ट में एक नई "ब्लैक Google टी" डाली गई है.

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 ID फ़ॉर्मैट) का इस्तेमाल करें:

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 में आपको सिर्फ़ उन फ़ील्ड की जानकारी देनी होगी जिनमें बदलाव करना है.

किसी एट्रिब्यूट को जोड़ने या उसमें बदलाव करने के लिए, 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 संसाधन से मिटा दिया जाएगा.

दिखाए गए उदाहरण में, 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

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

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"
   ]
  }
 ]
}
पीछे जाएं
प्रॉडक्ट ID
आगे बढ़ें
बैच मोड