Bạn có thể sử dụng từ custombatch đến insert, get hoặc delete nhiều sản phẩm ở một
thời gian bằng 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. productId
không bắt buộc đối với lệnh gọi API chèn cho custombatch.
custombatch:insert
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 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à 1111 và 1112
và là mã nhận dạng duy nhất cho mỗi 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à là phương thức
là get, delete hoặc insert.
insert tạo ra một sản phẩm mới. Nếu các giá trị tồn tại cho các thuộc tính
channel, contentLanguage, offerId và feedLabel cho một giá trị cụ thể
sản phẩm, 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ừ 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 đưa vào Merchant Center
bằng cách sử dụ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
bao gồm những sản phẩm bạn đã 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 dành riêng cho sản phẩm đó
đối với 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 2 sản phẩm
được chèn bằng cách sử dụng ví dụ custombatch:insert trước, được chỉ định
theo giá trị productId. 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"
]
}
}
]
}
custombatch:delete
URL yêu cầu sau được dùng để tạo products.custombatch với
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à giá trị duy nhất cho giá trị
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à các giá trị batchId của giá trị đã xoá
mục:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1115
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1116
}
]
}