REST Resource: accounts.productInputs

Kaynak: ProductInput

Bu kaynak, Merchant Center'da, Alışveriş reklamlarında veya Google platformlarında gördüğünüz işlenmiş ürünü değil, bir ürün için gönderdiğiniz giriş verilerini temsil eder. Ürün girişleri, kurallar ve ek veri kaynağı verileri birleştirilerek işlenmiş Product oluşturulur.

Veri doğrulama kontrollerini geçmek için gerekli ürün girişi özellikleri öncelikle Ürün Verileri Spesifikasyonu'nda tanımlanır.

Şu özellikler gereklidir: feedLabel, contentLanguage ve offerId.

Bir ürün girişi ekledikten, güncelledikten veya sildikten sonra, işlenen ürünün alınabilmesi birkaç dakika sürebilir.

Ürün girişindeki ve alt iletilerindeki tüm alanlar, bazı istisnalar dışında dikey spesifikasyondaki ilgili özelliklerin İngilizce adıyla eşleşir.

JSON gösterimi
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Alanlar
name

string

Tanımlayıcı. Ürün girişinin adı. Biçim: "{productinput.name=accounts/{account}/productInputs/{productinput}}". Son bölüm productinput 4 bölümden oluşur: channel~contentLanguage~feedLabel~offerId. Ürün girişi adı örneği: "accounts/123/productInputs/online~tr~TR~sku123".

product

string

Yalnızca çıkış. İşlenen ürünün adı. Biçim: "{product.name=accounts/{account}/products/{product}}"

channel

enum (ChannelEnum)

Zorunlu. Değişmez. Ürünün kanalı.

offerId

string

Zorunlu. Değişmez. Ürününüz için benzersiz tanımlayıcınız. Bu durum, ürün girişi ve işlenmiş ürün için aynıdır. Baştaki ve sondaki boşluklar kaldırılır ve birden fazla boşluk tek bir boşlukla değiştirilir. Ayrıntılar için ürün verileri spesifikasyonuna bakın.

contentLanguage

string

Zorunlu. Değişmez. Ürünün iki harfli ISO 639-1 dil kodu.

feedLabel

string

Zorunlu. Değişmez. Ürünün feed etiketi.

attributes

object (Attributes)

İsteğe bağlı. Ürün özelliklerinin listesi.

customAttributes[]

object (CustomAttribute)

İsteğe bağlı. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, API tarafından açıkça gösterilmeyen özellikleri (ör. Google ile Satın Al için kullanılan ek özellikler) göndermek için kullanışlıdır. Her özel özellik için izin verilen maksimum karakter sayısı 10.240'tür (ad ve değer için karakterlerin toplamını temsil eder). Ürün başına en fazla 2.500 özel özellik ayarlanabilir. Bu özelliklerin toplam boyutu 102, 4 KB'ı aşmamalıdır. Özel özellik adlarındaki alt çizgiler, eklendikten sonra boşluklarla değiştirilir.

versionNumber

string (int64 format)

İsteğe bağlı. Ürünün mevcut sürümünü (tazeliğini) temsil eder. Aynı anda birden fazla güncelleme yapıldığında doğru sırayı korumak için kullanılabilir.

Ayarlanırsa sürüm numarası mevcut ürünün mevcut sürüm numarasından düşük olduğunda ekleme engellenir. Yeniden ekleme (örneğin, 30 gün sonra ürün yenileme) mevcut versionNumber ile yapılabilir.

Yalnızca birincil veri kaynaklarına eklemeler için desteklenir.

İşlem engellenirse iptal edilen istisna atılır.

Yöntemler

delete

Merchant Center hesabınızdaki bir ürün girişini siler.

insert

Merchant Center hesabınıza ürün girişi yükler.