Bạn có thể sử dụng custombatch để insert, get hoặc delete nhiều sản phẩm cùng một lúc trong một lệnh gọi API duy nhất.
Sử dụng URL yêu cầu sau đây để gọi các API hàng loạt tuỳ chỉnh:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Phần nội dung yêu cầu chứa các tham số cụ thể: batchId, merchantID và method.
Chỉ sử dụng productId nếu bạn đang thực thi một thao tác get hoặc delete. Bạn không bắt buộc phải dùng productId trong lệnh gọi API chèn cho custombatch.
custombatch:insert
URL yêu cầu sau đây được dùng để thực hiện một products.custombatch method=insert
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Để chèn 2 sản phẩm mới, hãy chỉ định batchId cho từng sản phẩm, merchantId của người bán được phép thực hiện lệnh gọi API và phương thức insert.
Trong ví dụ sau, các giá trị batchId lần lượt là 1111 và 1112, đồng thời là giá trị nhận dạng riêng biệt cho từng sản phẩm. merchantId:
1234567 là người bán được phép thực hiện lệnh gọi API và phương thức này là get, delete hoặc insert.
insert sẽ tạo một sản phẩm mới. Nếu có giá trị cho các thuộc tính channel, contentLanguage, offerId và feedLabel cho một sản phẩm nhất định, thì phương thức này sẽ cập nhật mục và thay thế tất cả dữ liệu từ các lệnh gọi API trước đó cho sản phẩm.
Dưới đây là một mẫu nội dung JSON để insert hai áo thun vào cơ sở dữ liệu Merchant Center bằng một lệnh gọi API duy nhất:
{
"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"
]
}
}
]
}
Lệnh gọi API thành công sẽ trả về mã HTTP 200 và phản hồi JSON bao gồm các sản phẩm đã được chèn. Định dạng của JSON trả về tương tự như sau:
{
"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
URL yêu cầu sau đây thực hiện lệnh gọi products.custombatch bằng method=get:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Để nhận một sản phẩm, hãy chỉ định batchId riêng biệt cho sản phẩm đó cho lệnh gọi API, merchantId của người bán được phép thực hiện lệnh gọi API, phương thức get và productId của sản phẩm đang được truy xuất.
Sau đây là nội dung yêu cầu JSON mẫu để truy xuất 2 sản phẩm được chèn bằng ví dụ custombatch:insert trước đó, được chỉ định theo giá trị productId của chúng. batchId là duy nhất cho mỗi mục trong danh sách:
{
"entries": [
{
"batchId": 1113,
"merchantId": 1234567,
"method": "get",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1114,
"merchantId": 1234567,
"method": "get",
"productId": "online:en:US:2222222222"
}
]
}
Lệnh gọi này trả về mã HTTP 200 và nội dung phản hồi sau:
{
"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
URL yêu cầu sau đây được dùng để tạo products.custombatch bằng method=delete:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Để xoá một sản phẩm, hãy chỉ định batchId là duy nhất đối với sản phẩm trong lệnh gọi API này, merchantId của người bán được phép thực hiện lệnh gọi API này, phương thức delete và productId của sản phẩm sẽ bị xoá.
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"productId": "online:en:US:2222222222"
}
]
}
Lệnh gọi này trả về mã HTTP 200 và các giá trị batchId của các mục đã xoá:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1115
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1116
}
]
}