Package google.shopping.merchant.products.v1beta

Dizin

ProductInputsService

ProductInput kaynağını kullanacak hizmet. Bu hizmet yalnızca online kanalı olan ürünlerde çalışır.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Merchant Center hesabınıza ürün girişi yükler. Aynı contentLanguage, offerId ve dataSource değerlerine sahip bir giriş zaten varsa bu yöntem söz konusu girişin yerini alır.

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

ProductsService

Ürün kaynağını kullanacak hizmet. Bu hizmet yalnızca online kanalı olan ürünlerde çalışır.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Merchant Center hesabınızda işlenen ürünleri listeler. Yanıt, pageSize tarafından belirtilenden daha az öğe içerebilir. İstenecek başka öğe olup olmadığını belirlemek için pageToken değerini kullanın.

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

Özellikler

Özellikler.

Alanlar
expiration_date

Timestamp

Öğenin geçerlilik süresinin sona ereceği tarih (ekleme sırasında belirtildiği şekilde) ISO 8601 biçiminde. Gerçek son kullanma tarihi, productstatuses içinde googleExpirationDate olarak gösterilir ve expirationDate çok ilerideyse daha erken olabilir.
disclosure_date

Timestamp

Bir teklifin Google'ın YouTube platformlarındaki arama sonuçlarında gösterilmeye başladığı tarih ve saat (ISO 8601 biçiminde). Daha fazla bilgi için [Açıklama tarihi]( https://support.google.com/merchants/answer/13034208) başlıklı makaleyi inceleyin.
availability_date

Timestamp

Ön sipariş verilen bir ürünün teslimata hazır olacağı gün (ISO 8601 biçiminde).
gtin[]

string

Öğenin Global Ticari Öğe Numaraları (GTIN). En fazla 10 GTIN sağlayabilirsiniz.
price

Price

Öğenin fiyatı.
installment

Installment

Bir öğe için ödenecek taksit sayısı ve tutarı.
subscription_cost

SubscriptionCost

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

LoyaltyPoints

Kullanıcıların öğeyi satın aldıktan sonra aldığı bağlılık puanları. Yalnızca Japonya.
loyalty_programs[]

LoyaltyProgram

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

string

Öğenin kategorileri (ürün verileri spesifikasyonunda olduğu gibi biçimlendirilir).
sale_price

Price

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

Interval

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

ProductDimension

Ürünün, sağlanan birim cinsinden yüksekliği. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.
product_length

ProductDimension

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

ProductDimension

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

ProductWeight

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

Shipping

Kargo kuralları.
free_shipping_threshold[]

FreeShippingThreshold

Bir ürünün ücretsiz kargo sunabilmesi için karşılanması gereken koşullar.
shipping_weight

ShippingWeight

Kargo için öğenin ağırlığı.
shipping_length

ShippingDimension

Kargo için öğenin uzunluğu.
shipping_width

ShippingDimension

Kargo için öğenin genişliği.
shipping_height

ShippingDimension

Kargo için öğenin yüksekliği.
size_types[]

string

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

Tax

Vergi bilgileri.
unit_pricing_measure

UnitPricingMeasure

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

UnitPricingBaseMeasure

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

string

ads_grouping'e benzer ancak yalnızca TBM'de çalışır.
cost_of_goods_sold

Price

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

ProductDetail

Teknik özellikler veya ek ürün bilgileri.
product_highlights[]

string

Bir ürünün en alakalı özelliklerini açıklayan madde noktaları.
display_ads_similar_ids[]

string

Reklamveren tarafından belirtilen öneriler.
promotion_ids[]

string

Bir promosyonun benzersiz kimliği.
included_destinations[]

string

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

string

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

string

Teklifin Alışveriş reklamları hedefinden hariç tutulacağı ü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.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

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

Certification

Ürün sertifikaları (ör. AB EPREL veritabanına kaydedilen ürünlerin enerji verimliliği etiketleme sertifikaları). Daha fazla bilgi için Yardım Merkezi makalesini inceleyin.
auto_pricing_min_price

Price

"Otomatik İndirimler" (https://support.google.com/merchants/answer/10295759) ve "Dinamik Promosyonlar" (https://support.google.com/merchants/answer/13949249) projelerinde, satıcı tekliflerindeki indirimlerin bu değerin altına düşmemesini ve böylece teklifin değerini ve kârlılığını korumasını sağlayan bir önlem.
sustainability_incentives[]

ProductSustainabilityIncentive

Sürdürülebilirlik teşvik programlarının listesi.
identifier_exists

bool

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

bool

Öğenin satıcı tarafından tanımlanan bir paket olup olmadığı. Paket, satıcı tarafından tek fiyat üzerinden satılan farklı ürünlerin özel bir gruplandırılmasıdır.
title

string

Öğenin başlığı.
description

string

Öğenin açıklaması.
adult

bool

Öğe yetişkinlere yönelikse doğru değerine ayarlayın.
age_group

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.
google_product_category

string

Google'ın öğe kategorisi (Google ürün sınıflandırmasına bakın). Ürünler sorgulanırken bu alan, kullanıcı tarafından sağlanan değeri içerir. Otomatik olarak atanan Google ürün kategorilerini API üzerinden geri almak şu anda mümkün değildir.
item_group_id

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 (ör. puantiyeli).
sell_on_google_quantity

int64

Google'da satışa hazır ürün miktarı. Yalnızca online ürünler için desteklenir.
max_handling_time

int64

Ürünlerin maksimum sevkiyata hazırlık süresi (iş günü cinsinden).
min_handling_time

int64

Ürünlerin minimum sevkiyata hazırlık süresi (iş günü cinsinden).
shipping_label

string

Ürünün kargo etiketidir. Ürünü hesap düzeyindeki kargo kurallarında gruplandırmak için kullanılır.
transit_time_label

string

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

string

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

string

Bedenin belirtildiği sistem. Giyim öğeleri için önerilir.
tax_category

string

Ürünün vergi kategorisi.
energy_efficiency_class

string

AB 2010/30/AB direktifinde tanımlanan enerji verimlilik sınıfı.
min_energy_efficiency_class

string

AB 2010/30/AB direktifinde tanımlanan enerji verimlilik sınıfı.
max_energy_efficiency_class

string

AB 2010/30/AB direktifinde tanımlanan enerji verimlilik sınıfı.
multipack

int64

Satıcı tarafından tanımlanan çoklu ambalajdaki benzer ürünlerin sayısıdır.
ads_grouping

string

Öğeleri isteğe bağlı bir şekilde gruplandırmak için kullanılır. Yalnızca EBM% içindir. Aksi takdirde önerilmez.
ads_redirect

string

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

string

Dinamik yeniden pazarlama kampanyaları için bir öğenin tanımlayıcısı.
display_ads_title

string

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

double

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

string

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

string

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

string

Alışveriş kampanyasındaki öğelerin özel gruplandırılması için özel etiket 0.
custom_label_1

string

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

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 2.
custom_label_3

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 3.
custom_label_4

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 4.
external_seller_id

string

Çok satıcılı hesaplar için gereklidir. Bu özelliği, çeşitli satıcılara ait ürünleri çok satıcılı hesabınıza yükleyen bir pazar yeriyseniz kullanın.
pause

string

Bu öğenin yayını geçici olarak duraklatılır.
structured_title

ProductStructuredTitle

Algoritma tarafından (yapay zeka) oluşturulan başlıklar için yapılandırılmış başlık.
structured_description

ProductStructuredDescription

Algoritma tarafından (yapay zeka) oluşturulan açıklamalar için yapılandırılmış açıklama.

Sertifika

İlk olarak AB EPREL veritabanı kullanılarak AB enerji verimliliği etiketleme uyumluluğu için kullanıma sunulan ürün sertifikasıdır.

Alanlar
certification_authority

string

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

string

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

string

Sertifika kodu. Maksimum uzunluk 2.000 karakterdir.
certification_value

string

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

CloudExportAdditionalProperties

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

Alanlar
text_value[]

string

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

int64

Belirtilen mülkün tam sayı değerleri. Örneğin, TV ürünü ekran çözünürlüğü için 1080. Bu değerin maksimum tekrar sayısı 400'dür. Değerler, rastgele ancak tutarlı bir sırada depolanır.
float_value[]

float

Belirli bir mülkün kayan değerleri. Örneğin, TV ürünü için 1.2345. Bu değerin maksimum tekrar sayısı 400'dür. Değerler, rastgele ancak tutarlı bir sırada depolanır.
property_name

string

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

bool

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

float

Belirtilen mülkün minimum kayan nokta değeri. Örneğin, TV ürünü için 1,00.
max_value

float

Belirtilen özelliğin maksimum kayan değeri. Örneğin, TV ürünü için 100,00.
unit_code

string

Belirtilen mülkün birimi. Örneğin, TV ürünü için "Piksel". Maksimum dize boyutu 256B'tır.

DeleteProductInputRequest

DeleteProductInput yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek ürün giriş kaynağının adı. Biçim: accounts/{hesap}/productInputs/{ürün}. Son bölüm product 4 bölümden oluşur: channel~content_language~feed_label~offer_id. Ürün adı örneği: "accounts/123/productInputs/online~tr~TR~sku123"
data_source

string

Zorunlu. Ürün girişinin silinmesi gereken birincil veya ek veri kaynağı. Biçim: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Bir ürünün ücretsiz kargo sunabilmesi için karşılanması gereken koşullar.

Alanlar
country

string

Bir öğenin gönderileceği ülkenin CLDR bölge kodu.
price_threshold

Price

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

GetProductRequest

GetProduct yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak ürünün adı. Biçim: accounts/{account}/products/{product}. Son bölüm product 4 bölümden oluşur: channel~content_language~feed_label~offer_id. Ürün adı örneği: "accounts/123/products/online~tr~TR~sku123"

InsertProductInputRequest

InsertProductInput yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu ürünün ekleneceği hesap. Biçim: accounts/{account}
product_input

ProductInput

Zorunlu. Eklenecek ürün girişi.
data_source

string

Zorunlu. Birincil veya ek ürün veri kaynağının adı. Ürün zaten mevcutsa ve sağlanan veri kaynağı farklıysa ürün yeni bir veri kaynağına taşınır.

Yalnızca API veri kaynakları desteklenir.

Biçim: accounts/{account}/dataSources/{datasource}.

Taksit

Taksitleri temsil eden bir mesaj.

Alanlar
months

int64

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

Price

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

Price

Alıcının ödemesi gereken peşinat tutarı.
credit_type

string

Taksit ödemelerinin türü. Desteklenen değerler: * "finance" * "lease"

ListProductsRequest

ListProducts yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. İşlenen ürünlerin listeleneceği hesap. Biçim: accounts/{account}
page_size

int32

İade edilecek maksimum ürün sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Maksimum değer 250'dir. 250'den yüksek değerler 250'ye zorlanacaktır. Belirtilmemesi durumunda maksimum ürün sayısı döndürülür.
page_token

string

Önceki bir ListProducts çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yapılırken ListProducts parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListProductsResponse

ListProducts yöntemi için yanıt mesajı.

Alanlar
products[]

Product

Belirtilen hesaptaki işlenmiş ürünler. Bunlar, kurallar ve ek veri kaynakları uygulandıktan sonra işlenen ürünlerinizdir.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

LoyaltyPoints

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

Alanlar
name

string

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

int64

Perakendecinin mutlak değerdeki bağlılık puanları.
ratio

double

Puanın, para birimine dönüştürüldüğündeki oranı. Google, para birimini Merchant Center ayarlarına göre tahmin eder. Oran atlanırsa varsayılan olarak 1, 0 olur.

LoyaltyProgram

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

Alanlar
program_label

string

Bağlılık programının etiketi. Bu, bir satıcı öğesi ile bağlılık programı öğesi arasındaki ilişkiyi benzersiz şekilde tanımlayan dahili bir etikettir. Sistem 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.
tier_label

string

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

Price

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

Price

Gelecekteki satın alma işlemlerinde kullanılabilecek geri ödeme.
loyalty_points

int64

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

Interval

Öğenin üye fiyatına uygun olduğu tarih aralığı. Belirtilmezse üye fiyatı her zaman geçerli olur. Tarih aralığı, boşluk, virgül veya eğik çizgiyle ayrılmış bir çift ISO 8601 tarihiyle temsil edilir.
shipping_label

string

Kargo avantajının etiketi. Alanda bir değer varsa bu teklifte bağlılık kapsamında kargo avantajı vardır. Alan değeri sağlanmazsa öğe, belirli bir bağlılık katmanı için bağlılık kapsamındaki gönderim için uygun değildir.

Ürün

Kurallar ve ek veri kaynakları uygulandıktan sonra birden fazla product inputs'ten oluşturulan işlenmiş ürün. Bu işlenmiş ürün, Merchant Center hesabınızda, Alışveriş reklamlarında ve Google'daki diğer platformlarda gösterilenlerle eşleşir. Her ürün, tam olarak bir birincil veri kaynağı ürün girişinden ve birden fazla ek veri kaynağı girişinden oluşur. Bir ürün girişi ekledikten, güncelledikten veya sildikten sonra, güncellenmiş ve işlenmiş ürünün alınabilmesi birkaç dakika sürebilir.

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

Alanlar
name

string

Ürünün adı. Biçim: "{product.name=accounts/{account}/products/{product}}". Son bölüm product 4 bölümden oluşur: channel~content_language~feed_label~offer_id. Ürün adı örneği: "accounts/123/products/online~tr~TR~sku123"
channel

ChannelEnum

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

string

Yalnızca çıkış. Ü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.
content_language

string

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

string

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

string

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

Attributes

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

CustomAttribute

Yalnızca çıkış. Ö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.
product_status

ProductStatus

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

int64

Yalnızca çıkış. Ü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 (ör. 30 gün sonra ürün yenileme) mevcut version_number ile yapılabilir.

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

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

ProductDetail

Ürün ayrıntıları.

Alanlar
section_name

string

Bir dizi ürün ayrıntısını gruplandırmak için kullanılan bölüm başlığı.
attribute_name

string

Ürün ayrıntısının adı.
attribute_value

string

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

ProductDimension

Ürünün boyutu.

Alanlar
value

double

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

string

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

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.

Alanlar
name

string

Tanımlayıcı. Ürün girişinin adı. Biçim: "{productinput.name=accounts/{account}/productInputs/{productinput}}" (productinput son bölümü 4 bölümden oluşur: channel~content_language~feed_label~offer_id. Ü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

ChannelEnum

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

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.
content_language

string

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

string

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

Attributes

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

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.
version_number

int64

İ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 (ör. 30 gün sonra ürün yenileme) mevcut version_number ile yapılabilir.

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

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

ProductStatus

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

Alanlar
destination_statuses[]

DestinationStatus

Ürünün hedeflenen hedefleri.
item_level_issues[]

ItemLevelIssue

Ürünle ilişkili tüm sorunların listesi.
creation_date

Timestamp

Öğenin oluşturulduğu tarih (ISO 8601 biçiminde).
last_update_date

Timestamp

Öğenin son güncellendiği tarih (ISO 8601 biçiminde).
google_expiration_date

Timestamp

Öğenin süresinin dolan tarihi (ISO 8601 biçiminde).

DestinationStatus

Ürün durumunun hedef durumu.

Alanlar
reporting_context

ReportingContextEnum

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

string

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

string

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

string

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

ItemLevelIssue

Ürün durumunun ItemLevelIssue özelliği.

Alanlar
code

string

Sorunun hata kodu.
severity

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ı.
reporting_context

ReportingContextEnum

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

string

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

string

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

string

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

string

Sorunun teklif için 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ü doğrudan etkilemez.
DEMOTED Ürünün sıralaması düşürüldü ve büyük olasılıkla arama sonuçlarında sınırlı performans gösteriyor
DISAPPROVED Sorun nedeniyle ürün onaylanmaz.

ProductStructuredDescription

Algoritma tarafından (yapay zeka) oluşturulan açıklamalar için yapılandırılmış açıklama.

Alanlar
digital_source_type

string

Dijital kaynak türü (ör. "trained_algorithmic_media"). IPTC'ye uygun olmalıdır. Maksimum uzunluk 40 karakterdir.
content

string

Açıklama metninin maksimum uzunluğu 5.000 karakterdir.

ProductStructuredTitle

Algoritma tarafından (yapay zeka) oluşturulan başlıklar için yapılandırılmış başlık.

Alanlar
digital_source_type

string

Dijital kaynak türü (ör. "trained_algorithmic_media"). IPTC'ye uygun olmalıdır. Maksimum uzunluk 40 karakterdir.
content

string

Başlık metninin maksimum uzunluğu 150 karakterdir.

ProductSustainabilityIncentive

İndirim veya vergi indirimi gibi sürdürülebilirlikle ilgili teşvik programlarıyla ilgili bilgiler.

Alanlar
Birlik alanı value. Sürdürülebilirlik teşviki değeri. value yalnızca aşağıdakilerden biri olabilir:
amount

Price

Teşvikin sabit tutarı.
percentage

double

Teşvikin uygulandığı satış fiyatının yüzdesi.
type

Type

Sürdürülebilirlik teşvik programı.

Tür

Desteklenen sürdürülebilirlik teşvik programı türleri.

Sıralamalar
TYPE_UNSPECIFIED Belirtilmemiş veya bilinmeyen sürdürülebilirlik teşviki türü.
EV_TAX_CREDIT Elektrikli araçlar ve bazı ülkelerde plug-in hibritler için vergi yükümlülüğü indirimleri sunan program. Bu indirimler, belirli bir tutara veya satış fiyatının yüzdesine göre belirlenebilir.
EV_PRICE_DISCOUNT Genellikle çevre bonusu olarak adlandırılan sübvansiyon programı, elektrikli araçlar ve bazı ülkelerde plug-in hibritler için satın alma desteği sağlar. Hibe tutarı, sabit bir tutar veya satış fiyatının yüzdesi olabilir.

ProductWeight

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

Alanlar
value

double

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

string

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

Gönderim

Ürünün gönderimi.

Alanlar
price

Price

Sabit kargo fiyatı, sayı olarak gösterilir.
country

string

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

string

Kargo ücretinin geçerli olduğu coğrafi bölge. Daha fazla bilgi için region parametresine bakın.
service

string

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

int64

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

string

Gönderimin geçerli olduğu konum. Bir konum grubu adıyla temsil edilir.
postal_code

string

Kargo ücretinin geçerli olduğu posta kodu aralığı. Posta kodu, posta kodu ön eki ve ardından * joker karakteri, iki posta kodu veya eşit uzunlukta iki posta kodu ön eki ile temsil edilir.
min_handling_time

int64

Sipariş alındığı tarih ile gönderildiği tarih arasında iş günü cinsinden minimum sevkiyata hazırlık süresi (dahil). 0, son sipariş saatinden önce alındığında siparişin aynı gün gönderildiği anlamına gelir. minHandlingTime yalnızca maxHandlingTime ile birlikte bulunabilir ancak maxHandlingTime varsa gerekli değildir.
max_handling_time

int64

Sipariş alındığı tarih ile gönderildiği tarih arasında iş günü cinsinden maksimum sevkiyata hazırlık süresi (dahil). 0, son sipariş saatinden önce alındığında siparişin aynı gün gönderildiği anlamına gelir. Kargo hızları sağlanıyorsa hem maxHandlingTime hem de maxTransitTime gereklidir. maxHandlingTime varsa minHandlingTime isteğe bağlıdır.
min_transit_time

int64

Sipariş gönderildikten sonra iş günü cinsinden teslimat süresi (dahil). 0, siparişin gönderildiği gün teslim edildiği anlamına gelir. minTransitTime yalnızca maxTransitTime ile birlikte bulunabilir ancak maxTransitTime varsa gerekli değildir.
max_transit_time

int64

Sipariş gönderildikten sonra iş günü cinsinden teslim edilene kadar geçen maksimum nakliye süresi (dahil). 0, siparişin gönderildiği gün teslim edildiği anlamına gelir. Kargo hızları sağlanıyorsa hem maxHandlingTime hem de maxTransitTime gereklidir. maxTransitTime varsa minTransitTime isteğe bağlıdır.

ShippingDimension

Ürünün ShippingDimension özelliği.

Alanlar
value

double

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

string

Değer birimi.

ShippingWeight

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

Alanlar
value

double

Ürünün kargo maliyetinin hesaplanması için kullanılan ağırlığıdır.
unit

string

Değer birimi.

SubscriptionCost

Ürünün SubscriptionCost değeri.

Alanlar
period

SubscriptionPeriod

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

int64

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

Price

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

SubscriptionPeriod

Ürünün abonelik dönemi.

Sıralamalar
SUBSCRIPTION_PERIOD_UNSPECIFIED Abonelik döneminin belirtilmediğini gösterir.
MONTH Abonelik döneminin ay olduğunu belirtir.
YEAR Abonelik süresinin yıl olduğunu gösterir.

Vergi

Ürünün vergisi.

Alanlar
rate

double

Öğe fiyatı için geçerli 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.
tax_ship

bool

Gönderim bedelinden vergi alınıyorsa doğru değerine ayarlayın.
location_id

int64

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

string

Vergi oranının geçerli olduğu posta kodu aralığı. Bu aralığı temsil eden bir posta kodu, * joker karakteri kullanılan bir posta kodu ön eki, iki posta kodu veya eşit uzunlukta iki posta kodu ön eki arasındaki bir aralık olabilir. Örnekler: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

Ürünün UnitPricingBaseMeasure özelliği.

Alanlar
value

int64

Birim fiyatının paydası.
unit

string

Paydanın birimi.

UnitPricingMeasure

Ürünün UnitPricingMeasure değeri.

Alanlar
value

double

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

string

Ölçü birimi.