Anda dapat menggunakan feed tambahan untuk melakukan pembaruan parsial 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 membuat 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, sehingga 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 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 dihapus akan dihapus dari feed. Perilaku ini berbeda dari pemanggilan products.insert
tanpa feed tambahan, yang akan menghapus semua data produk yang ada dan menggantinya dengan kolom yang Anda kirim dalam isi permintaan.
Gunakan URL berikut untuk mengajukan 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. Memanggil metode ini untuk feed tambahan tidak memengaruhi data produk asli yang ditambahkan sebelum panggilan Product.insert
feed tambahan dilakukan. Anda dapat menganggap hal 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. Hal ini
berbeda dari memanggil products.delete
tanpa feed tambahan, yang
akan 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 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
Untuk memperbarui nilai price
bagi 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 melakukan 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"
}
]
}