Anda dapat menggunakan feed tambahan untuk melakukan pembaruan parsial pada data produk dengan menambahkan
feedId sebagai parameter kueri saat melakukan panggilan ke
products.insert
products.delete,
products.custombatch.insert,
dan
products.custombatch.delete
metode.
Misalnya, Anda dapat membuat panggilan metode feed tambahan products.insert untuk
URL berikut:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
Metode products.insert feed tambahan menambahkan kolom produk yang Anda kirimkan
dalam isi permintaan, menimpa kolom tersebut jika ada. Saat menggunakan
feed tambahan, metode ini tidak mengubah semua kolom produk lainnya, kecuali
kolom telah disertakan dalam permintaan sebelumnya untuk feed yang sama. Meskipun data
yang ditambahkan melalui feed lain tidak akan terpengaruh. Setiap permintaan akan menimpa permintaan sebelumnya
permintaan untuk feed yang sama. Artinya, jika Anda menambahkan atau memperbarui kolom melalui
permintaan feed tambahan, lalu tidak menyertakan kolom tersebut dalam
permintaan, data untuk kolom yang dihilangkan akan dihapus dari feed. Perilaku ini
berbeda dengan memanggil products.insert tanpa feed tambahan, yang
menghapus semua data produk yang ada dan menggantinya dengan kolom yang Anda kirim
isi permintaan.
Gunakan URL berikut untuk membuat permintaan ke feed tambahan
Layanan Product.insert:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
Anda harus menyertakan offerId, feedLabel, channel, dan
Kolom contentLanguage dalam isi permintaan. Semua kolom lainnya bersifat opsional.
Contoh
Untuk mengubah ketersediaan produk dari "tersedia" menjadi "stok habis", Anda dapat
dapat menggunakan isi permintaan berikut untuk membuat feed tambahan
Panggilan metode Product.insert:
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
Metode products.delete menghapus semua data tambahan yang
sebelumnya ditambahkan oleh products.insert panggilan menggunakan
feed Anda. Memanggil metode ini untuk feed tambahan tidak memengaruhi versi asli
data produk yang ditambahkan sebelum feed tambahan Product.insert panggilan
dilakukan. Anggap saja ini seperti menghapus lapisan data untuk feed tertentu;
data yang ditambahkan melalui feed lain tidak akan terpengaruh, dan produk akan efektif
kembali ke keadaan sebelumnya sebelum lapisan feed tambahan ditambahkan. Ini
berbeda dengan memanggil products.delete tanpa feed tambahan, yang
menghapus seluruh produk dan semua datanya.
Gunakan URL berikut untuk mengajukan permintaan feed tambahan products.delete
layanan, dengan productId sebagai
ID REST
dari produk, direpresentasikan sebagai: channel:contentLanguage:feedLabel:offerId:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
Tidak ada isi permintaan yang diperlukan untuk panggilan metode products.delete feed tambahan.
products.custombatch
Metode custombatch memungkinkan Anda insert atau delete feed tambahan
data untuk beberapa produk menggunakan satu panggilan API untuk meminimalkan jumlah API
panggilan yang dilakukan.
Gunakan URL permintaan berikut untuk melakukan panggilan custombatch:
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Untuk semua panggilan custombatch feed tambahan, Anda harus menyertakan batchId,
Parameter merchantID, method, dan feedId dalam permintaan
{i>body <i}itu.
products.custombatch:insert
Saat melakukan panggilan feed tambahan ke metode products.custombatch:insert,
Anda harus menyertakan offerId, feedLabel, channel, dan
contentLanguage dalam isi permintaan, selain batchId yang diperlukan,
Parameter merchantID, dan method. Semua kolom produk lainnya bersifat opsional.
Contoh
Untuk memperbarui nilai price untuk dua produk yang ada, Anda dapat menggunakan
permintaan berikut untuk melakukan panggilan metode 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
Untuk menghapus semua pembaruan yang dilakukan pada dua produk melalui feed tambahan yang ditentukan,
Anda dapat menggunakan permintaan berikut untuk membuat products.custombatch:delete
pemanggilan metode:
{
"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"
}
]
}