Anda dapat menggunakan feed tambahan untuk melakukan pembaruan sebagian pada data produk dengan menambahkan feedId
sebagai parameter kueri saat melakukan panggilan ke metode products.insert
, products.delete
, products.custombatch.insert
, dan products.custombatch.delete
.
Misalnya, Anda dapat melakukan panggilan metode feed tambahan products.insert
ke 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 kirim dalam isi permintaan, dan menimpa kolom tersebut jika ada. Saat menggunakan feed tambahan, metode ini tidak mengubah semua kolom produk lainnya, kecuali jika kolom tersebut 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 untuk feed yang sama. Artinya, jika Anda menambahkan atau memperbarui kolom melalui permintaan feed tambahan, lalu tidak menyertakan kolom tersebut dalam permintaan berikutnya, data untuk kolom yang dihilangkan akan dihapus dari feed. Perilaku ini berbeda dengan pemanggilan products.insert
tanpa feed tambahan, yang menghapus semua data produk yang ada dan menggantinya dengan kolom yang Anda kirim dalam isi permintaan.
Gunakan URL berikut untuk membuat permintaan ke layanan Product.insert
feed tambahan:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
Anda harus menyertakan kolom offerId
, feedLabel
, channel
, dan
contentLanguage
dalam isi permintaan. Semua kolom lainnya bersifat opsional.
Contoh
Untuk mengubah ketersediaan produk dari “tersedia” menjadi “stok habis”, Anda dapat menggunakan isi permintaan berikut untuk membuat panggilan metode Product.insert
feed tambahan:
{
"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 panggilan products.insert
menggunakan feed
tambahan yang ditentukan. Pemanggilan metode ini untuk feed tambahan tidak memengaruhi data produk asli yang ditambahkan sebelum panggilan Product.insert
feed tambahan dilakukan. Anggaplah ini seperti menghapus lapisan data untuk feed tertentu; data yang ditambahkan melalui feed lain tidak akan terpengaruh, dan produk secara efektif kembali ke status sebelumnya sebelum lapisan feed tambahan ditambahkan. Cara ini berbeda dengan memanggil products.delete
tanpa feed tambahan, yang menghapus seluruh produk dan semua datanya.
Gunakan URL berikut untuk membuat permintaan ke layanan products.delete
feed tambahan, dengan productId
adalah ID REST produk, yang 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 melakukan insert
atau delete
data feed tambahan untuk beberapa produk menggunakan satu panggilan API untuk meminimalkan jumlah panggilan API 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 parameter batchId
,
merchantID
, method
, dan feedId
dalam isi
permintaan.
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 parameter batchId
,
merchantID
, dan method
yang diperlukan. Semua kolom produk lainnya bersifat opsional.
Contoh
Guna memperbarui nilai price
untuk dua produk yang sudah 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 panggilan metode 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"
}
]
}