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