products.insert
,
products.delete
,
products.custombatch.insert
ve
products.custombatch.delete
yöntemlerine çağrı yaparken feedId
'yi sorgu parametresi olarak ekleyerek ürün verilerinde kısmi güncellemeler yapmak üzere ek feed'leri kullanabilirsiniz.
Örneğin, aşağıdaki URL'ye bir products.insert
ek feed yöntemi çağrısı yapabilirsiniz:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
Ek feed products.insert
yöntemi, istek gövdesine gönderdiğiniz ürün alanlarını ekler ve varsa bu alanların üzerine yazar. Ek feed kullanılırken bu yöntem, aynı feed için daha önce gönderilen bir isteğe dahil edilmiş olmayan diğer tüm ürün alanlarını değiştirmez. Diğer feed'ler aracılığıyla eklenen veriler etkilenmese de her istek, aynı feed için önceki isteklerin üzerine yazılır. Yani ek feed isteği aracılığıyla bir alan ekler veya mevcut bir alanı güncellerseniz ve daha sonra bu alanı sonraki bir isteğe dahil etmezseniz çıkarılan alana ait veriler feed'den kaldırılır. Bu davranış, mevcut tüm ürün verilerini silip istek gövdesinde gönderdiğiniz alanlarla değiştiren ek feed olmadan products.insert
çağrısından farklıdır.
Ek feed Product.insert
hizmetine istek göndermek için aşağıdaki URL'yi kullanın:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
offerId
, feedLabel
, channel
ve contentLanguage
alanlarını istek gövdesine eklemeniz gerekir. Diğer tüm alanlar isteğe bağlıdır.
Örnek
Bir ürünün "stokta" olan stok durumunu "stokta yok" olarak değiştirmek amacıyla ek feed'ler Product.insert
yöntem çağrısı oluşturmak için aşağıdaki istek gövdesini kullanabilirsiniz:
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
products.delete
yöntemi, belirtilen ek feed kullanılarak daha önce products.insert
çağrıları tarafından eklenen tüm ek verileri kaldırır. Bu yöntemin ek feed için çağrılması, ek feed Product.insert
çağrısı yapılmadan önce eklenen orijinal ürün verilerini etkilemez. Bunu, belirli bir feed'e ait bir veri katmanını kaldırmak gibi düşünebilirsiniz. Diğer feed'ler aracılığıyla eklenen veriler etkilenmez ve ürün, ek feed katmanı eklenmeden önceki durumuna etkili bir şekilde döner. Bu durum, products.delete
ürününün ek feed olmadan çağrılmasından farklıdır. Bu durumda ek feed, ürünün tamamını ve tüm verilerini siler.
Ek feed products.delete
hizmetinden istekte bulunmak için aşağıdaki URL'yi kullanın. Burada productId
, ürünün channel:contentLanguage:feedLabel:offerId
şeklinde gösterilen REST kimliğidir:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
products.delete
yöntemi ek feed'leri için istek gövdesi gerekmez.
products.custombatch
custombatch
yöntemleri, yapılan API çağrılarının sayısını en aza indirmek amacıyla tek bir API çağrısı kullanarak birden fazla ürün için insert
veya delete
ek feed verileri oluşturmanıza olanak tanır.
Bir custombatch
çağrısı yapmak için aşağıdaki istek URL'sini kullanın:
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Tüm ek feed custombatch
çağrıları için istek gövdesine batchId
, merchantID
, method
ve feedId
parametrelerini eklemeniz gerekir.
products.custombatch:insert
products.custombatch:insert
yöntemine ek feed çağrıları yaparken gerekli batchId
, merchantID
ve method
parametrelerine ek olarak offerId
, feedLabel
, channel
ve contentLanguage
öğelerini istek gövdesine eklemeniz gerekir. Diğer tüm ürün alanları isteğe bağlıdır.
Örnek
Mevcut iki ürünün price
değerini güncellemek için aşağıdaki isteği kullanarak bir products.custombatch:insert
yöntem çağrısı yapabilirsiniz:
{
"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
Belirtilen ek feed aracılığıyla iki üründe yapılan tüm güncellemeleri kaldırmak için aşağıdaki isteği kullanarak products.custombatch:delete
yöntemi çağrısı yapabilirsiniz:
{
"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"
}
]
}