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"
}
]
}