custombatch
का इस्तेमाल insert
, get
या delete
के एक से ज़्यादा प्रॉडक्ट के लिए किया जा सकता है
कितना समय लगेगा.
कस्टम बैच एपीआई को कॉल करने के लिए, इस अनुरोध यूआरएल का इस्तेमाल करें:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
अनुरोध के मुख्य हिस्से में ये पैरामीटर शामिल हैं: batchId
, merchantID
,
और एक method
.
productId
का इस्तेमाल सिर्फ़ तब करें, जब get या delete को एक्ज़ीक्यूट किया जा रहा हो. productId
custombatch
के लिए Insert API कॉल के लिए, वैल्यू डालना ज़रूरी नहीं है.
custombatch:insert
इस अनुरोध के यूआरएल का इस्तेमाल, products.custombatch method=insert
बनाने के लिए किया जाता है
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
दो नए प्रॉडक्ट जोड़ने के लिए, हर प्रॉडक्ट के लिए batchId
तय करें.
एपीआई कॉल करने की अनुमति वाले कारोबारी या कंपनी के merchantId
और तरीके
insert
.
यहां दिए गए उदाहरण में, batchId
की वैल्यू 1111
और 1112
हैं
और हर प्रॉडक्ट के यूनीक आइडेंटिफ़ायर होते हैं. merchantId:
1234567
, वह व्यापारी/कंपनी है जिसके पास एपीआई कॉल करने की अनुमति है. साथ ही, यह तरीका
है get
, delete
या insert
.
insert
एक नया प्रॉडक्ट बनाता है. अगर एट्रिब्यूट के लिए वैल्यू मौजूद हों
किसी दी गई रकम के लिए channel
, contentLanguage
, offerId
, और feedLabel
प्रॉडक्ट है, तो यह तरीका एंट्री को अपडेट करता है और पिछले एपीआई के पूरे डेटा को बदल देता है
प्रॉडक्ट के लिए कॉल करता है.
Merchant Center में insert
दो टी-शर्ट के लिए, JSON फ़ॉर्मैट का सैंपल यहां दिया गया है
इस डेटाबेस में सिंगल एपीआई कॉल का इस्तेमाल किया जाता है:
{
"entries": [
{
"batchId": 1111,
"merchantId": 1234567,
"method": "insert",
"product": {
"kind": "content#product",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing and
features a retail fit.",
"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"
],
"includedDestination": [
"Shopping"
]
}
},
{
"batchId": 1112,
"merchantId": 1234567,
"method": "insert",
"product": {
"kind": "content#product",
"offerId": "2222222222",
"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"
],
"includedDestination": [
"Shopping"
]
}
}
]
}
एपीआई कॉल पूरा होने पर, HTTP 200
कोड और JSON रिस्पॉन्स मिलता है
में डाले गए प्रॉडक्ट शामिल हैं. रिटर्न JSON का फ़ॉर्मैट
निम्न के समान है:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1111,
"product": {
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing and
features a retail fit.",
"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"
],
"includedDestination": [
"Shopping"
]
}
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1112,
"product": {
"kind": "content#product",
"id": "online:en:US:2222222222",
"offerId": "2222222222",
"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"
],
"includedDestination": [
"Shopping"
]
}
}
]
}
custombatch:get
यह अनुरोध यूआरएल, products.custombatch
से कॉल करता है
method=get
:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
प्रॉडक्ट पाने के लिए, उस प्रॉडक्ट के लिए खास batchId
की जानकारी दें
एपीआई कॉल के लिए, व्यापारी/कंपनी का merchantId
एपीआई कॉल, get
तरीका, और वापस लाए जा रहे प्रॉडक्ट का productId
.
दोनों प्रॉडक्ट वापस पाने के लिए, JSON अनुरोध का मुख्य हिस्सा नीचे दिया गया है
पिछले custombatch:insert
उदाहरण का इस्तेमाल करके शामिल किया गया, जिसके बारे में बताया गया है
productId
की वैल्यू के हिसाब से. सूची में मौजूद हर आइटम के लिए batchId
यूनीक होता है:
{
"entries": [
{
"batchId": 1113,
"merchantId": 1234567,
"method": "get",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1114,
"merchantId": 1234567,
"method": "get",
"productId": "online:en:US:2222222222"
}
]
}
यह कॉल एक HTTP 200
कोड और जवाब का यह मुख्य हिस्सा दिखाता है:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1113,
"product": {
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
"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"
],
"includedDestination": [
"Shopping"
]
}
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1114,
"product": {
"kind": "content#product",
"id": "online:en:US:2222222222",
"offerId": "2222222222",
"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"
],
"includedDestination": [
"Shopping"
]
}
}
]
}
custombatch:delete
इस अनुरोध यूआरएल का इस्तेमाल products.custombatch
बनाने के लिए किया जाता है
method=delete
:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
किसी प्रॉडक्ट को मिटाने के लिए, वह batchId
बताएं जो
इस एपीआई कॉल में मौजूद प्रॉडक्ट के लिए, व्यापारी/कंपनी का merchantId
यह एपीआई कॉल करें, तरीका delete
, और प्रॉडक्ट का productId
हटाया जा रहा है.
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"productId": "online:en:US:2222222222"
}
]
}
यह कॉल, मिटाए गए कोड के लिए HTTP 200
कोड और batchId
वैल्यू दिखाता है
आइटम:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1115
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1116
}
]
}