Bạn có thể sử dụng nguồn cấp dữ liệu bổ sung để cập nhật một phần dữ liệu sản phẩm bằng cách thêm feedId
làm tham số truy vấn khi thực hiện lệnh gọi đến phương thức products.insert
, products.delete
, products.custombatch.insert
và products.custombatch.delete
.
Ví dụ: bạn có thể thực hiện lệnh gọi phương thức nguồn cấp dữ liệu bổ sung products.insert
đến URL sau:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
Phương thức products.insert
của nguồn cấp dữ liệu bổ sung sẽ thêm các trường sản phẩm bạn gửi vào nội dung yêu cầu và ghi đè các trường đó nếu có. Khi sử dụng nguồn cấp dữ liệu bổ sung, phương thức này sẽ giữ nguyên tất cả các trường sản phẩm khác, trừ phi các trường này đã được đưa vào yêu cầu trước đó cho cùng một nguồn cấp dữ liệu. Mặc dù dữ liệu được thêm qua các nguồn cấp dữ liệu khác không bị ảnh hưởng, nhưng mỗi yêu cầu sẽ ghi đè các yêu cầu trước đó cho cùng một nguồn cấp dữ liệu. Điều này có nghĩa là nếu bạn thêm hoặc cập nhật một trường thông qua yêu cầu nguồn cấp dữ liệu bổ sung, sau đó không đưa trường đó vào yêu cầu tiếp theo, thì dữ liệu của trường đã bỏ qua sẽ bị xoá khỏi nguồn cấp dữ liệu. Hành vi này khác với việc gọi products.insert
mà không có nguồn cấp dữ liệu bổ sung. Thao tác này sẽ xoá tất cả dữ liệu sản phẩm hiện có và thay thế bằng các trường mà bạn gửi trong nội dung yêu cầu.
Sử dụng URL sau để yêu cầu dịch vụ Product.insert
của nguồn cấp dữ liệu bổ sung:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
Bạn phải thêm các trường offerId
, feedLabel
, channel
và contentLanguage
vào nội dung yêu cầu. Tất cả các trường khác là không bắt buộc.
Ví dụ:
Để thay đổi tình trạng còn hàng của một sản phẩm từ "còn hàng" thành "hết hàng", bạn có thể sử dụng nội dung yêu cầu sau đây để thực hiện lệnh gọi phương thức Product.insert
của nguồn cấp dữ liệu bổ sung:
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
Phương thức products.delete
sẽ xoá mọi dữ liệu bổ sung mà các lệnh gọi products.insert
đã thêm trước đó bằng cách sử dụng nguồn cấp dữ liệu bổ sung được chỉ định. Việc gọi phương thức này cho nguồn cấp dữ liệu bổ sung không ảnh hưởng đến dữ liệu sản phẩm gốc đã thêm trước khi thực hiện lệnh gọi Product.insert
cho nguồn cấp dữ liệu bổ sung. Bạn có thể coi việc này giống như việc xoá lớp dữ liệu cho một nguồn cấp dữ liệu cụ thể; dữ liệu được thêm qua các nguồn cấp dữ liệu khác sẽ không bị ảnh hưởng và sản phẩm hoàn nguyên về trạng thái trước đó một cách hiệu quả trước khi lớp nguồn cấp dữ liệu bổ sung được thêm vào. Cách này khác với việc gọi products.delete
mà không có nguồn cấp dữ liệu bổ sung, việc này sẽ xoá toàn bộ sản phẩm và tất cả dữ liệu của sản phẩm đó.
Sử dụng URL sau để yêu cầu dịch vụ nguồn cấp dữ liệu bổ sung products.delete
, trong đó productId
là mã REST của sản phẩm, được biểu thị dưới dạng: channel:contentLanguage:feedLabel:offerId
:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
Không cần nội dung yêu cầu cho các lệnh gọi phương thức products.delete
của nguồn cấp dữ liệu bổ sung.
products.custombatch
Các phương thức custombatch
cho phép bạn insert
hoặc delete
cung cấp dữ liệu của nguồn cấp dữ liệu bổ sung cho nhiều sản phẩm bằng cách sử dụng một lệnh gọi API duy nhất để giảm thiểu số lệnh gọi API được thực hiện.
Sử dụng URL yêu cầu sau để thực hiện lệnh gọi custombatch
:
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Đối với tất cả các lệnh gọi custombatch
của nguồn cấp dữ liệu bổ sung, bạn phải đưa các tham số batchId
, merchantID
, method
và feedId
vào nội dung yêu cầu.
products.custombatch:insert
Khi thực hiện lệnh gọi nguồn cấp dữ liệu bổ sung đến phương thức products.custombatch:insert
, bạn phải đưa offerId
, feedLabel
, channel
và contentLanguage
vào nội dung yêu cầu, ngoài các thông số batchId
, merchantID
và method
bắt buộc. Tất cả các trường sản phẩm khác là không bắt buộc.
Ví dụ:
Để cập nhật giá trị price
cho 2 sản phẩm hiện có, bạn có thể sử dụng yêu cầu sau để thực hiện lệnh gọi phương thức products.custombatch:insert
:.
{
"entries": [
{
"batchId": 1111,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "30.99",
"currency": "USD"
}
}
},
{
"batchId": 1112,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "2222222222",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "33.99",
"currency": "USD"
},
},
}
}
products.custombatch:delete
Để xoá tất cả nội dung cập nhật đối với hai sản phẩm thông qua nguồn cấp dữ liệu bổ sung được chỉ định, bạn có thể dùng yêu cầu sau để thực hiện lệnh gọi phương thức products.custombatch:delete
:
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:2222222222"
}
]
}