Bạn có thể sử dụng custombatch đến 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.
Sử dụng URL yêu cầu sau để thực hiện lệnh gọi đến các API lô tuỳ chỉnh:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
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 lệnh get hoặc Delete. Bạn không bắt buộc phải có productId đối với lệnh gọi API chèn cho custombatch.
tuỳ chỉnh:chèn
URL yêu cầu sau được dùng để tạo products.custombatch method=insert
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Để chèn hai sản phẩm mới, hãy chỉ định batchId cho mỗi sản phẩm, merchantId của người bán được uỷ quyền 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, và là các giá trị nhận dạng duy nhất cho từng sản phẩm. merchantId:
1234567 là người bán được uỷ quyền để thực hiện lệnh gọi API và phương thức này là get, delete hoặc insert.
insert tạo ra một sản phẩm mới. Nếu tồn tại các giá trị cho các thuộc tính channel, contentLanguage, offerId và feedLabel của một sản phẩm nhất định, thì phương thức này sẽ cập nhật mục nhập 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à nội dung JSON mẫu cho insert hai chiếc áo phông 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ột mã HTTP 200 và phản hồi JSON có chứa các sản phẩm đã được chèn. Định dạng của JSON trả về sẽ 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"
]
}
}
]
}
tùy chỉnh lô:lấy
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 dành riêng cho sản phẩm cho lệnh gọi API, merchantId của người bán được uỷ quyền để 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 hai sản phẩm đã chèn bằng ví dụ custombatch:insert trước, được chỉ định bằng các giá trị productId của chúng. batchId là giá trị 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 đây:
{
"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"
]
}
}
]
}
tuỳ chỉnh:xoá
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 dành riêng cho sản phẩm đó trong lệnh gọi API này, merchantId của người bán được uỷ quyền để thực hiện lệnh gọi API này, phương thức delete và productId của sản phẩm đang 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à giá trị batchId của các mục đã xoá:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1115
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1116
}
]
}