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/ |
https://shop.example.com/ |
https://shop.example.com/ |
GTIN | 9504000059422 | 9504000059446 | 9504000059452 |
एमपीएन | 00638NIC | 00638ANG | 00638ABC |
ब्रैंड | |||
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"
]
}
]
}