REST Resource: accounts.products

Kaynak: Ürün

Kurallar ve ek veri kaynakları uygulandıktan sonra birden fazla [ürün girişi][[google.shopping.content.bundles.Products.ProductInput] ile oluşturulan işlenmiş ürün. Bu işlenmiş ürün, Merchant Center hesabınızda, Alışveriş reklamlarında ve diğer Google platformlarında gösterilenlerle eşleşir. Her ürün tam olarak bir tane birincil veri kaynağı ürün girişi ve birden fazla ek veri kaynağı girişiyle oluşturulur. Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, güncellenen işlenmiş ürünün alınması birkaç dakika sürebilir.

İşlenen üründeki ve alt mesajlarındaki tüm alanlar, bazı istisnalar dışında Ürün verileri spesifikasyonundaki ilgili özelliklerin adlarıyla eşleşir.

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

string

Ürünün adı. Biçim: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Yalnızca çıkış. Ürünün kanalı.
offerId

string

Yalnızca çıkış. Ürün için benzersiz tanımlayıcınızdır. Bu değer, ürün girişi ve işlenen ürün için aynıdır. Gönderildikten sonra 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

Yalnızca çıkış. Ürünün iki harfli ISO 639-1 dil kodu.
feedLabel

string

Yalnızca çıkış. Ürünün feed etiketi.
dataSource

string

Yalnızca çıkış. Ürünün birincil veri kaynağı.
attributes

object (Attributes)

Yalnızca çıkış. Ürün özelliklerinin listesi.
customAttributes[]

object (CustomAttribute)

Yalnızca çıkış. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Ayrıca veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, Google ile Satın Al için kullanılan ek özellikler gibi API tarafından açıkça gösterilmeyen özelliklerin gönderilmesi açısından da faydalıdır.
productStatus

object (ProductStatus)

Yalnızca çıkış. Bir ürünün durumu, veri doğrulama sorunları, yani eşzamansız olarak hesaplanan bir ürünle ilgili bilgiler.
versionNumber

string (int64 format)

Yalnızca çıkış. Ürünün mevcut sürümünü (güncelliğini) gösterir. Bu sürüm, 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 geçerli sürüm numarasından düşük olduğunda ekleme işlemi engellenir. Mevcut versionNumber ile yeniden ekleme (örneğin, 30 gün sonra ürün yenileme) işlemi gerçekleştirilebilir.

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

İşlem engellenirse iptal edilen istisna uygulanır.

Özellikler

Özellikler.

JSON gösterimi 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Alanlar
expirationDate

string (Timestamp format)

Ekleme işleminden sonra belirtildiği gibi, ISO 8601 biçiminde belirtilen, öğenin geçerlilik süresinin dolacağı tarih. Gerçek son kullanma tarihi productstatuses içinde googleExpirationDate olarak gösterilir ve expirationDate çok ilerideyse daha erken olabilir.
disclosureDate

string (Timestamp format)

Bir teklifin Google'ın YouTube platformlarındaki arama sonuçlarında görünür hale geldiği, ISO 8601 biçiminde belirtilen tarih. Daha fazla bilgi için [Bilgilendirme tarihine]( https://support.google.com/merchants/answer/13034208) göz atın.
availabilityDate

string (Timestamp format)

ISO 8601 biçiminde, ön sipariş verilen bir ürünün teslimata hazır olacağı gün.
price

object (Price)

Öğenin fiyatı.
installment

object (Installment)

Öğe için ödenecek taksitin sayısı ve tutarı.
subscriptionCost

object (SubscriptionCost)

İlişkili abonelik sözleşmesi olan bir öğenin dönem sayısı (ay veya yıl) ve dönem başına ödeme tutarı.
loyaltyPoints

object (LoyaltyPoints)

Kullanıcıların öğeyi satın aldıktan sonra kazandıkları bağlılık puanları. Japonya'ya özeldir.
loyaltyPrograms[]

object (LoyaltyProgram)

Bu öğenin kullanıcısına bağlılık programı avantajlarını (ör. daha iyi fiyat, puanlar vb.) göstermek için kullanılan bağlılık programı bilgilerinin listesi.
productTypes[]

string

Öğenin kategorileri (ürün verileri spesifikasyonunda olduğu gibi biçimlendirilmiştir).
salePrice

object (Price)

Öğenin reklamı yapılan indirimli fiyatı.
salePriceEffectiveDate

object (Interval)

Öğenin indirimde olduğu tarih aralığı (ürün verileri spesifikasyonuna bakın).
productHeight

object (ProductDimension)

Sağlanan birimlerde ürünün yüksekliği. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.
productLength

object (ProductDimension)

Ürünün, sağlanan birimlerde uzunluğu. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.
productWidth

object (ProductDimension)

Ürünün, sağlanan birimler cinsinden genişliği. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.
productWeight

object (ProductWeight)

Ürünün sağlanan birimlerdeki ağırlığı. Değer 0 (hariç) ile 2.000 (dahil) arasında olmalıdır.
shipping[]

object (Shipping)

Kargo kuralları.
freeShippingThreshold[]

object (FreeShippingThreshold)

Bir ürünün ücretsiz gönderimi için karşılanması gereken koşullar.
shippingWeight

object (ShippingWeight)

Gönderim için öğenin ağırlığı.
shippingLength

object (ShippingDimension)

Gönderilecek öğenin uzunluğu.
shippingWidth

object (ShippingDimension)

Gönderim için öğenin genişliği.
shippingHeight

object (ShippingDimension)

Gönderim için öğenin yüksekliği.
sizeTypes[]

string

Öğenin kesimi. Giyim öğeleri için birleşik beden türlerini göstermek üzere kullanılabilir. En fazla iki beden türü sağlanabilir (bkz. [https://support.google.com/merchants/answer/6324497](beden türü).
taxes[]

object (Tax)

Vergi bilgileri.
unitPricingMeasure

object (UnitPricingMeasure)

Bir öğenin ölçüsü ve boyutu.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

Birim fiyat paydasının tercihi.
adsLabels[]

string

adsGrouping'e benzer, ancak yalnızca TBM ile çalışır.
costOfGoodsSold

object (Price)

Satılan malların maliyeti. Brüt kâr raporlaması için kullanılır.
productDetails[]

object (ProductDetail)

Teknik spesifikasyon veya ek ürün ayrıntıları.
productHighlights[]

string

Ürünün öne çıkan en alakalı özelliklerini açıklayan madde işaretleri.
displayAdsSimilarIds[]

string

Reklamveren tarafından belirtilen öneriler.
promotionIds[]

string

Bir promosyonun benzersiz kimliği.
includedDestinations[]

string

Bu hedef için dahil edilecek hedeflerin listesi (Merchant Center'daki işaretli onay kutularına karşılık gelir). excludedDestinations içinde sağlanmadığı sürece varsayılan hedefler her zaman dahil edilir.
excludedDestinations[]

string

Bu hedef için hariç tutulacak hedeflerin listesi (Merchant Center'daki işaretlenmemiş onay kutularına karşılık gelir).
shoppingAdsExcludedCountries[]

string

Teklifi Alışveriş Reklamları hedefinden hariç tutacak ülke kodlarının (ISO 3166-1 alpha-2) listesi. Bu listedeki ülkeler, veri kaynağı ayarlarında yapılandırılan ülkelerden kaldırılır.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Cloud Perakende programına aktarılacak ek alanlar.
certifications[]

object (Certification)

Ürün Sertifikaları (ör. AB EPREL veritabanında kayıtlı ürünlerin enerji verimliliği etiketlemesi için). Daha fazla bilgi için Yardım Merkezi makalesini inceleyin.
autoPricingMinPrice

object (Price)

"Otomatik İndirimler" (https://support.google.com/merchants/answer/10295759) ve "Dinamik Promosyonlar" (https://support.google.com/merchants/answer/13949249) projelerinde, satıcıların tekliflerindeki indirimlerin bu değerin altında kalmamasını ve böylece teklifin değerini ve kârlılığını korumayı sağlayan bir önlemdir.
identifierExists

boolean

Öğenin kategorisine uygun benzersiz ürün tanımlayıcıları (ör. GTIN, MPN ve marka) yoksa bu değeri false (yanlış) olarak ayarlayın. Sağlanmazsa varsayılan olarak "true" değerine ayarlanır.
isBundle

boolean

Öğenin satıcı tarafından tanımlanan bir paket olup olmadığı. Paket, bir satıcı tarafından tek bir fiyata satılan farklı ürünlerden oluşan özel bir gruptur.
title

string

Öğenin başlığı.
description

string

Öğenin açıklaması.
adult

boolean

Öğe yetişkinleri hedefliyorsa "doğru" olarak ayarlanır.
ageGroup

string

Öğenin hedef yaş grubu.
availability

string

Öğenin stok durumu.
brand

string

Öğenin markası.
color

string

Öğenin rengi.
condition

string

Öğenin durumu.
gender

string

Öğenin hedef cinsiyeti.
googleProductCategory

string

Google'ın öğe kategorisi (Google ürün sınıflandırması bölümüne bakın). Ürünleri sorgularken bu alan, kullanıcı tarafından sağlanan değeri içerir. Şu anda API aracılığıyla otomatik olarak atanan Google ürün kategorilerini geri almanın bir yolu yoktur.
gtin

string

Öğenin Global Ticari Öğe Numarası (GTIN).
itemGroupId

string

Aynı ürünün tüm varyantlarının ortak tanımlayıcısı.
material

string

Öğenin yapıldığı malzeme.
mpn

string

Öğenin Üretici Parça Numarası (MPN).
pattern

string

Öğenin deseni (örneğin, puantiyeli).
sellOnGoogleQuantity

string (int64 format)

Ürünün Google'da satılabilecek miktarı. Yalnızca online ürünler için desteklenir.
maxHandlingTime

string (int64 format)

Maksimum ürün sevkiyata hazırlık süresi (iş günü olarak).
minHandlingTime

string (int64 format)

Minimum ürün sevkiyata hazırlık süresi (iş günü olarak).
shippingLabel

string

Ürünün gönderi etiketi; ürünü hesap düzeyindeki gönderim kurallarında gruplandırmak için kullanılır.
transitTimeLabel

string

Ürünün, hesap düzeyindeki nakliye süresi tablolarında ürünü gruplandırmak için kullanılan nakliye süresi etiketi.
size

string

Öğenin bedeni. Yalnızca bir değere izin verilir. Farklı bedenlere sahip varyantlarda aynı itemGroupId değerine sahip her beden için ayrı bir ürün ekleyin (bkz. [https://support.google.com/merchants/answer/6324492](beden tanımı).
sizeSystem

string

Boyutun belirtildiği sistem. Giyim öğeleri için önerilir.
taxCategory

string

Ürünün vergi kategorisi. Hesap düzeyindeki vergi ayarlarında ayrıntılı vergi bağlantı noktalarını yapılandırmak için kullanılır.
energyEfficiencyClass

string

2010/30/EU sayılı AB yönergesinde tanımlanan enerji verimlilik sınıfı.
minEnergyEfficiencyClass

string

2010/30/EU sayılı AB yönergesinde tanımlanan enerji verimlilik sınıfı.
maxEnergyEfficiencyClass

string

2010/30/EU sayılı AB yönergesinde tanımlanan enerji verimlilik sınıfı.
multipack

string (int64 format)

Bir satıcı tarafından tanımlanan çoklu ambalajdaki benzer ürünlerin sayısıdır.
adsGrouping

string

Öğeleri rastgele bir şekilde gruplandırmak için kullanılır. Yalnızca EBM yüzdesi için. Aksi takdirde önerilmez.
adsRedirect

string

Ürün, Ürün reklamları bağlamında gösterildiğinde reklamverenlerin öğe URL'sini geçersiz kılmasına olanak tanır.
displayAdsId

string

Dinamik yeniden pazarlama kampanyalarına yönelik bir öğenin tanımlayıcısı.
displayAdsTitle

string

Dinamik yeniden pazarlama kampanyaları için bir öğenin başlığı.
displayAdsValue

number

Dinamik yeniden pazarlama kampanyaları için teklif marjı.
pickupMethod

string

Öğenin teslim alma seçeneği.
pickupSla

string

Öğenin mağazadan teslim alınabileceği zaman çizelgesi.
customLabel0

string

Bir Alışveriş kampanyasındaki öğelerin özel gruplandırması için özel etiket 0.
customLabel1

string

Bir Alışveriş kampanyasındaki öğelerin özel gruplandırılması için özel etiket 1.
customLabel2

string

Bir Alışveriş kampanyasındaki öğelerin özel gruplandırılması için özel etiket 2.
customLabel3

string

Bir Alışveriş kampanyasındaki öğelerin özel gruplandırılması için özel etiket 3.
customLabel4

string

Bir Alışveriş kampanyasındaki öğelerin özel gruplandırılması için özel etiket 4.
externalSellerId

string

Çok satıcılı hesaplar için gereklidir. Çok satıcılı hesabınıza çeşitli satıcıların ürünlerini yükleyen bir pazar yeriyseniz bu özelliği kullanın.
pause

string

Bu öğenin yayınlanması geçici olarak duraklatılacak.
structuredTitle

object (ProductStructuredTitle)

Algoritmik olarak (AI) oluşturulan başlıklar için yapılandırılmış başlık.
structuredDescription

object (ProductStructuredDescription)

Algoritmik (AI) tarafından üretilen açıklamalar için yapılandırılmış açıklama.

Taksit

Taksiti temsil eden bir mesaj.

JSON gösterimi 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Alanlar
months

string (int64 format)

Alıcının ödemesi gereken taksit sayısı.
amount

object (Price)

Alıcının her ay ödemesi gereken tutar.
downpayment

object (Price)

Alıcının ödemesi gereken ön ödeme tutarı.
creditType

string

Taksitli ödemelerin türü. Desteklenen değerler: * "finance" * "lease"

SubscriptionCost

Ürünün SubscriptionMaliyeti.

JSON gösterimi 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Alanlar
period

enum (SubscriptionPeriod)

Abonelik döneminin türü. Desteklenen değerler: * "month" * "year"
periodLength

string (int64 format)

Alıcının ödemesi gereken abonelik dönemi sayısı.
amount

object (Price)

Alıcının abonelik dönemi başına ödemesi gereken tutar.

SubscriptionPeriod

Ürünün abonelik süresidir.

Sıralamalar
SUBSCRIPTION_PERIOD_UNSPECIFIED Abonelik döneminin belirtilmemiş olduğunu gösterir.
MONTH Abonelik döneminin ay olduğunu belirtir.
YEAR Abonelik döneminin yıl olduğunu belirtir.

LoyaltyPoints

Bağlılık puanlarını temsil eden bir mesajdır.

JSON gösterimi 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Alanlar
name

string

Bağlılık puanı programının adı. Adı 12 tam genişlikli karakterle veya 24 Latin alfabesi karakteriyle sınırlandırmanız önerilir.
pointsValue

string (int64 format)

Perakendecinin mutlak değer olarak bağlılık puanları.
ratio

number

Para birimine dönüştürülen puanın oranı. Google, Merchant Center ayarlarını temel alarak para birimini varsayar. Oran girilmezse varsayılan olarak 1, 0 olur.

LoyaltyProgram

Bağlılık programını temsil eden bir mesaj.

JSON gösterimi 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Alanlar
programLabel

string

Bağlılık programının etiketi. Bu, bir satıcı tüzel kişisi ile bağlılık programı tüzel kişiliği arasındaki ilişkiyi benzersiz şekilde tanımlayan dahili bir etikettir. Sistemin aşağıdaki öğeleri (ör. fiyat ve puanlar) bir satıcıyla ilişkilendirebilmesi için etiket sağlanmalıdır. İlgili program, satıcı hesabına bağlı olmalıdır.
tierLabel

string

Bağlılık programındaki katmanın etiketi. Programdaki etiketlerden biriyle eşleşmelidir.
price

object (Price)

Belirtilen katmanın üyeleri için sunulan fiyat, yani anında indirimli fiyat. Normal fiyattan daha küçük veya bu fiyata eşit olmalıdır.
cashbackForFutureUse

object (Price)

Gelecekteki satın alma işlemlerinde kullanılabilecek nakit para ödülü.
loyaltyPoints

string (int64 format)

Bir satın alma işleminde kazanılan bağlılık puanının tutarı.

ProductDimension

Ürünün boyutu.

JSON gösterimi 
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Zorunlu. Sayı olarak temsil edilen boyut değeri. Değerin hassasiyeti en fazla dört ondalık basamak olabilir.
unit

string

Zorunlu. Boyut birimleri. Kabul edilebilir değerler: * "in" * "cm"

ProductWeight

Ürünün ağırlığıdır.

JSON gösterimi 
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Zorunlu. Sayı olarak temsil edilen ağırlık. Ağırlık, en fazla dört ondalık basamak hassasiyetine sahip olabilir.
unit

string

Zorunlu. Ağırlık birimi. Kabul edilebilir değerler: * "g" * "kg" * "oz" * "lb"

Kargo

Ürünün kargo bilgisi.

JSON gösterimi 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Alanlar
price

object (Price)

Sayı olarak gösterilen sabit gönderim fiyatı.
country

string

Öğenin gönderileceği ülkenin CLDR bölge kodu.
region

string

Bir kargo ücretinin geçerli olduğu coğrafi bölge. Daha fazla bilgi için region [bölge] bölümüne bakın.
service

string

Hizmet sınıfının veya teslimat hızının serbest biçimli bir açıklaması.
locationId

string (int64 format)

AdWords API'de tanımlandığı şekilde, gönderim ücretinin geçerli olduğu bir konumun sayısal kimliği.
locationGroupName

string

Kargonun geçerli olduğu ve yer grubu adıyla gösterilen konum.
postalCode

string

Kargo ücretinin geçerli olduğu posta kodu aralığı. Posta kodu, posta kodu ön eki ve ardından * joker karakter, iki posta kodu arasındaki aralık veya eşit uzunluktaki iki posta kodu ön eki ile gösterilir.
minHandlingTime

string (int64 format)

Siparişin teslim alınması ile kargoya verilmesi arasındaki süre (iş günü içinde) arasında minimum sevkiyata hazırlık süresi (dahil). 0, siparişin son sipariş saatinden önce alındığı gün kargoya verildiği anlamına gelir. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] yalnızca [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] ile birlikte sunulabilir ancak [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] varsa gerekli değildir.
maxHandlingTime

string (int64 format)

Siparişin teslim alınması ile kargoya verildiği tarih arasında iş günü olarak belirlenen maksimum sevkiyata hazırlık süresi (dahil). 0, siparişin son sipariş saatinden önce alındığı gün kargoya verildiği anlamına gelir. Gönderim hızı sağlanıyorsa hem [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] hem de [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] gereklidir. [maxProcessTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] varsa [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] isteğe bağlıdır.
minTransitTime

string (int64 format)

Siparişin gönderildiği zamanla iş günü içinde teslim edildiği tarih arasındaki minimum nakliye süresi (dahil). 0 değeri, siparişin kargolandığı gün teslim edildiği anlamına gelir. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] yalnızca [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] ile birlikte bulunabilir ancak [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] mevcutsa gerekli değildir.
maxTransitTime

string (int64 format)

Siparişin gönderildiği tarih ile iş günü içinde teslim edildiği tarih arasındaki maksimum nakliye süresi (dahil). 0 değeri, siparişin kargolandığı gün teslim edildiği anlamına gelir. Gönderim hızı sağlanıyorsa hem [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] hem de [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] gereklidir. [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] varsa [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] isteğe bağlıdır.

FreeShippingThreshold

Bir ürünün ücretsiz gönderimi için karşılanması gereken koşullar.

JSON gösterimi 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Alanlar
country

string

Öğenin gönderileceği ülkenin CLDR bölge kodu.
priceThreshold

object (Price)

Kargo maliyetinin ücretsiz olması için minimum ürün fiyatıdır. Sayı olarak gösterilir.

ShippingWeight

Ürünün Kargo Ağırlığı.

JSON gösterimi 
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Öğenin gönderim maliyetinin hesaplanması için kullanılan ürün ağırlığıdır.
unit

string

Değer birimi.

ShippingDimension

Ürünün Kargo Boyutu.

JSON gösterimi 
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Öğenin gönderim maliyetinin hesaplanması için kullanılan ürün boyutu.
unit

string

Değer birimi.

Vergi

Ürünün Vergisi.

JSON gösterimi 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Alanlar
rate

number

Öğe fiyatına uygulanan vergi oranının yüzdesi.
country

string

Öğenin vergilendirildiği ülke. CLDR bölge kodu olarak belirtilir.
region

string

Vergi oranının geçerli olduğu coğrafi bölge.
taxShip

boolean

Kargo üzerinden vergi alınıyorsa doğru değerine ayarlanır.
locationId

string (int64 format)

AdWords API'de tanımlandığı şekilde, vergi oranının geçerli olduğu bir konumun sayısal kimliği.
postalCode

string

Vergi oranının geçerli olduğu posta kodu aralığı. Posta kodu, * joker karakteri kullanılan posta kodu ön eki, iki posta kodu arasındaki aralık veya aynı uzunluktaki iki posta kodu ön eki ile gösterilir. Örnekler: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

Ürünün Birim Fiyatlandırma Ölçüsüdür.

JSON gösterimi 
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Bir öğenin ölçüsü.
unit

string

Ölçü birimi.

UnitPricingBaseMeasure

Ürünün UnitPricingBaseMeasure değeri.

JSON gösterimi 
{
  "value": string,
  "unit": string
}
Alanlar
value

string (int64 format)

Birim fiyatın paydası.
unit

string

Paydanın birimi.

ProductDetail

Ürün ayrıntıları.

JSON gösterimi 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Alanlar
sectionName

string

Bir dizi ürün ayrıntılarını gruplandırmak için kullanılan bölüm üstbilgisi.
attributeName

string

Ürün ayrıntılarının adı.
attributeValue

string

Ürün ayrıntılarının değeri.

CloudExportAdditionalProperties

Cloud Retail API için ürün özelliği. Örneğin, bir TV ürününün özellikleri "Ekran Çözünürlüğü" veya "Ekran Boyutu" olabilir.

JSON gösterimi 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Alanlar
textValue[]

string

Belirtilen özelliğin metin değeri. Örneğin, "8K(UHD)", bir TV ürünü için metin değeri olabilir. Bu değerin maksimum tekrarlılığı 400'dür. Değerler rastgele ancak tutarlı bir sırada depolanır. Maksimum dize boyutu 256 karakterdir.
intValue[]

string (int64 format)

Belirtilen özelliğin tam sayı değerleri. Örneğin, bir TV ürününün Ekran Çözünürlüğü için 1080. Bu değerin maksimum tekrarlılığı 400'dür. Değerler rastgele ancak tutarlı bir sırada depolanır.
floatValue[]

number

Belirtilen özelliğin kayan noktalı değerleri. Örneğin, TV ürünü 1.2345. Bu değerin maksimum tekrarlılığı 400'dür. Değerler rastgele ancak tutarlı bir sırada depolanır.
propertyName

string

Belirtilen mülkün adı. Örneğin, bir TV ürünü için "Ekran Çözünürlüğü". Maksimum dize boyutu 256 karakterdir.
boolValue

boolean

Belirtilen özelliğin Boole değeri. Örneğin, TV ürünü için ekran UHD ise "Doğru" veya "Yanlış".
minValue

number

Belirli bir mülkün minimum kayan noktalı değeri. Örneğin, TV ürünü 1.00 için.
maxValue

number

Belirli bir mülkün maksimum kayan noktalı değeri. Örneğin, değeri 100,00 olan bir TV ürünü için geçerlidir.
unitCode

string

Belirtilen özelliğin birimi. Örneğin, bir TV ürünü için "Pikseller". Maksimum dize boyutu 256 B'dir.

Sertifika

Başlangıçta AB EPREL veritabanı kullanılarak AB enerji verimliliği etiketleme uygunluğu için kullanıma sunulan ürün sertifikası.

JSON gösterimi 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Alanlar
certificationAuthority

string

Sertifika yetkilisi (ör. "European_Commission"). Maksimum uzunluk 2.000 karakterdir.
certificationName

string

Sertifikanın adı (ör. "EPREL"). Maksimum uzunluk 2.000 karakterdir.
certificationCode

string

Sertifika kodu. Maksimum uzunluk 2.000 karakterdir.
certificationValue

string

Sertifika değeri (sınıf, seviye veya not olarak da bilinir), örneğin "A+", "C", "altın". Maksimum uzunluk 2.000 karakterdir.

ProductStructuredTitle

Algoritmik olarak (AI) oluşturulan başlıklar için yapılandırılmış başlık.

JSON gösterimi 
{
  "digitalSourceType": string,
  "content": string
}
Alanlar
digitalSourceType

string

Dijital kaynak türü (ör. "trained_algorithmic_media"). IPTC takip ediliyor. Maksimum uzunluk 40 karakterdir.
content

string

Başlık metni Maksimum uzunluk 150 karakterdir

ProductStructuredDescription

Algoritmik (AI) tarafından üretilen açıklamalar için yapılandırılmış açıklama.

JSON gösterimi 
{
  "digitalSourceType": string,
  "content": string
}
Alanlar
digitalSourceType

string

Dijital kaynak türü (ör. "trained_algorithmic_media"). IPTC takip ediliyor. Maksimum uzunluk 40 karakterdir.
content

string

Açıklama metni Maksimum uzunluk 5.000 karakterdir

ProductStatus

Bir ürünün durumu, veri doğrulama sorunları, yani eşzamansız olarak hesaplanan bir ürünle ilgili bilgiler.

JSON gösterimi 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Alanlar
destinationStatuses[]

object (DestinationStatus)

Ürün için amaçlanan hedefler.
itemLevelIssues[]

object (ItemLevelIssue)

Ürünle ilgili tüm sorunların listesi.
creationDate

string (Timestamp format)

ISO 8601 biçiminde, öğenin oluşturulduğu tarih.
lastUpdateDate

string (Timestamp format)

ISO 8601 biçiminde, öğenin son güncellendiği tarih.
googleExpirationDate

string (Timestamp format)

ISO 8601 biçiminde, öğenin süresinin dolacağı tarih.

DestinationStatus

Ürün durumunun hedef durumu.

JSON gösterimi 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Alanlar
reportingContext

enum (ReportingContextEnum)

Raporlama bağlamının adı.
approvedCountries[]

string

Teklifin onaylandığı ülke kodlarının listesi (ISO 3166-1 alpha-2).
pendingCountries[]

string

Teklifin onay beklediği ülke kodlarının (ISO 3166-1 alpha-2) listesi.
disapprovedCountries[]

string

Teklifin onaylanmadığı ülke kodlarının (ISO 3166-1 alpha-2) listesi.

ItemLevelIssue

Ürün durumunun ItemLevelIssue.

JSON gösterimi 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Alanlar
code

string

Sorunun hata kodu.
severity

enum (Severity)

Bu sorunun teklifin yayınlanmasını nasıl etkilediği.
resolution

string

Sorunun satıcı tarafından çözülüp çözülemeyeceği.
attribute

string

Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı.
reportingContext

enum (ReportingContextEnum)

Sorunun geçerli olduğu raporlama bağlamı.
description

string

İngilizce dilinde kısa bir sorun açıklaması.
detail

string

İngilizce dilinde ayrıntılı bir sorun açıklaması.
documentation

string

Bu sorunun çözümüne yardımcı olacak bir web sayfasının URL'si.
applicableCountries[]

string

Teklif için sorunun geçerli olduğu ülke kodlarının (ISO 3166-1 alpha-2) listesi.

Önem derecesi

Sorunun, ürünün yayınlanmasını nasıl etkilediği.

Sıralamalar
SEVERITY_UNSPECIFIED Belirtilmedi.
NOT_IMPACTED Bu sorun bir uyarı niteliğindedir ve ürün üzerinde doğrudan bir etkisi yoktur.
DEMOTED Ürünün sıralaması düşürüldü ve büyük olasılıkla arama sonuçlarındaki performansı sınırlı olacak.
DISAPPROVED Bir sorun nedeniyle ürün onaylanmadı.

Yöntemler

get

 İşlenen ürünü Merchant Center hesabınızdan alır.

list

 Merchant Center hesabınızdaki işlenmiş ürünleri listeler.