Content API ile ek feed'ler kullanma

Ürün verilerinde kısmi güncellemeler yapmak için feedId öğesini products.insert, products.delete, products.custombatch.insert ve products.custombatch.delete yöntemlerine göz atın.

Örneğin, products.insert aşağıdaki URL:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
.

products.insert

Ek feed products.insert yöntemi, gönderdiğiniz ürün alanlarını ekler bu alanları (varsa) üzerine yazın. bu yöntem, diğer tüm ürün alanlarını değiştirmeden bırakır. alanlar, aynı feed için daha önce yapılan bir talebe dahil edilmişti. Veriler sırasında diğer feed'ler üzerinden eklenenler etkilenmez, her istek önceki isteğini yerine getirir. Yani, bir alan adını kullanarak bir alan ekler veya mevcut bir alanı güncellerseniz ek feed isteğinde bulunabilir, ardından bu alanı sonraki bir isteği için, çıkarılan alana ait veriler feed'den kaldırılır. Bu davranış ek feed olmadan products.insert çağrısı yapmaktan farklıdır. Mevcut tüm ürün verilerini siler ve gönderdiğiniz alanlarla değiştirir istek gövdesine otomatik olarak eklenir.

Ek feed'e istek göndermek için aşağıdaki URL'yi kullanın. Product.insert hizmet:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

offerId, feedLabel, channel ve İstek gövdesinde contentLanguage alan var. Diğer tüm alanlar isteğe bağlıdır.

Örnek

Bir ürünün stok durumunu "stokta" yerine "stokta yok" olarak değiştirmek için ek feed oluşturmak için aşağıdaki istek gövdesini kullanabilir Product.insert yöntem çağrısı:

{
 "offerId": "1111111111",
 "contentLanguage": "en",
 "feedLabel": "US",
 "channel": "online",
 "availability": "out of stock",
}

products.delete

products.delete yöntemi, belirtilen ek veriler kullanılarak daha önce products.insert arama tarafından eklendi feed'i seçin. Ek feed için bu yöntemin çağrılması orijinal feed'i etkilemez Product.insert ek feed çağrısından önce eklenen ürün verileri yapar. Bunu, belirli bir feed'in 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 geri döner. Bu ek feed olmadan products.delete çağrısı yapmaktan farklıdır. Ürünün tamamını ve tüm verilerini siler.

products.delete ek feed'ine istekte bulunmak için aşağıdaki URL'yi kullanın. hizmet, burada productId değeri REST KİMLİĞİ şu şekilde temsil edilir: channel:contentLanguage:feedLabel:offerId:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

Ek feed'lerin products.delete yöntem çağrıları için istek gövdesine gerek yoktur.

products.custombatch

custombatch yöntemleriyle insert veya delete ek feed oluşturabilirsiniz API sayısını en aza indirmek için tek bir API çağrısı kullanan birden çok ürüne ait veriler arama yapıldı.

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 batchId, İstekteki merchantID, method ve feedId parametreleri gövde.

products.custombatch:insert

products.custombatch:insert yöntemine ek feed çağrıları yaparken şunları dahil etmelisiniz: offerId, feedLabel, channel ve istek gövdesinde contentLanguage, zorunlu batchId öğesine ek olarak, merchantID ve method parametreleri. 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 products.custombatch:insert yöntem çağrısı yapma isteği gönderildi:.

{
  "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

Belirli bir ek feed aracılığıyla iki üründe yapılan tüm güncellemeleri kaldırmak için: products.custombatch:delete oluşturmak için aşağıdaki isteği kullanabilirsiniz yöntem çağrısı:

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