Package google.shopping.merchant.products.v1beta

Dizin

ProductInputsService

ProductInput kaynağını kullanma hizmeti. Bu hizmet yalnızca online kanalı olan ürünler için kullanılabilir.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Bir ürün girişini Merchant Center hesabınızdan siler.

Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, işlenen ürünün alınması 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 (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

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

Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, işlenen ürünün alınması 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 (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

ProductsService

Ürün kaynağını kullanma hizmeti. Bu hizmet yalnızca online kanalı olan ürünler için kullanılabilir.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, güncellenen nihai ürünün alınması 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 (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Merchant Center hesabınızdaki işlenmiş ürünleri listeler. Yanıt, pageSize tarafından belirtilenden daha az öğe içerebilir. İstenecek daha fazla öğe olup olmadığını belirlemek için pageToken'a güvenin.

Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, güncellenen işlenmiş ürünün alınması 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 (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

Özellikler

Özellikler.

Alanlar
expiration_date

Timestamp

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

Timestamp

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

Timestamp

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

Price

Öğenin fiyatı.
installment

Installment

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

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

LoyaltyPoints

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

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.
product_types[]

string

Öğenin kategorileri (ürün verileri spesifikasyonunda olduğu gibi biçimlendirilmiştir).
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

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

ProductDimension

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

ProductDimension

Ürünün, sağlanan birimler 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 2.000 (dahil) arasında olmalıdır.
shipping[]

Shipping

Kargo kuralları.
free_shipping_threshold[]

FreeShippingThreshold

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

ShippingWeight

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

ShippingDimension

Gönderilecek öğenin uzunluğu.
shipping_width

ShippingDimension

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

ShippingDimension

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

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[]

Tax

Vergi bilgileri.
unit_pricing_measure

UnitPricingMeasure

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

UnitPricingBaseMeasure

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

string

ads_grouping'e benzer, ancak yalnızca TBM ile ç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 spesifikasyon veya ek ürün ayrıntıları.
product_highlights[]

string

Ürünün öne çıkan en alakalı özelliklerini açıklayan madde işaretleri.
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). excludedDestinations içinde sağlanmadığı sürece varsayılan hedefler her zaman dahil edilir.
excluded_destinations[]

string

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

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.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

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

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

bool

Öğ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.
is_bundle

bool

Öğ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

bool

Öğe yetişkinleri hedefliyorsa "doğru" olarak ayarlanır.
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ı 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).
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 (örneğin, puantiyeli).
sell_on_google_quantity

int64

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

int64

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

int64

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

string

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

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ı).
size_system

string

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

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

Dinamik yeniden pazarlama kampanyalarına yönelik 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

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

string

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

string

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

string

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

string

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

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

ProductStructuredTitle

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

ProductStructuredDescription

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

Sertifika

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

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, seviye veya not olarak da bilinir), örneğin "A+", "C", "altın". Maksimum uzunluk 2.000 karakterdir.

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.

Alanlar
text_value[]

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.
int_value[]

int64

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.
float_value[]

float

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

string

Belirtilen mülkün adı. Örneğin, bir 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, TV ürünü için ekran UHD ise "Doğru" veya "Yanlış".
min_value

float

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

float

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

string

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

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/{product}
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 gönderimi için karşılanması gereken koşullar.

Alanlar
country

string

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

Price

Kargo maliyetinin ücretsiz olması için minimum ürün fiyatıdır. 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}

InsertProductInputRequest

InsertProductInput yöntemi için istek mesajı.

Alanlar
parent

string

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

ProductInput

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

string

Zorunlu. Birincil veya ek ürün veri kaynağı adı. Ürün zaten mevcutsa ve sağlanan veri kaynağı farklıysa ürün yeni bir veri kaynağına taşınır. Biçim: accounts/{account}/dataSources/{datasource}.

Taksit

Taksiti 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 ön ödeme tutarı.
credit_type

string

Taksitli ödemelerin 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/{hesap}
page_size

int32

Döndürülecek maksimum ürün sayısı. Hizmet bu değerden daha az bir değer döndürebilir. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır. Belirtilmemişse maksimum sayıda ürün döndürülür.
page_token

string

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

Sayfalara ayırma işlemi sırasında ListProducts öğesine 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şlenen ürünler. Bunlar, kurallar ve ek veri kaynakları uygulandıktan sonra işlenmiş ürünlerinizdir.
next_page_token

string

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

LoyaltyPoints

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

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

int64

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

double

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.

Alanlar
program_label

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

string

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

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

Price

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

int64

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

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

Alanlar
name

string

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

ChannelEnum

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

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

ProductStatus

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

int64

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

ProductDetail

Ürün ayrıntıları.

Alanlar
section_name

string

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

string

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

string

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

ProductDimension

Ürünün boyutu.

Alanlar
value

double

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"

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 bir araya getirilerek işlenmiş [product][google.shopping.content.bundles.Products.Product] oluşturulur.

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

Şu özellikler gereklidir: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] ve [offerId][google.shopping.content.bundles.Products.offer_id].

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

Ürün girişi ve alt mesajlarındaki tüm alanlar, bazı istisnalar dışında, sektör spesifikasyonundaki karşılık gelen özelliğin İ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}}"
product

string

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

ChannelEnum

Zorunlu. Sabit. Ürünün kanalı.
offer_id

string

Zorunlu. Sabit. Ü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.
content_language

string

Zorunlu. Sabit. Ürünün iki harfli ISO 639-1 dil kodu.
feed_label

string

Zorunlu. Sabit. Ü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. 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 özellikleri 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 karakterlerinin toplamını gösterir). Ürün başına maksimum 2500 özel özellik belirlenebilir ve toplam boyut 102, 4 kB'tır. Özel özellik adlarındaki alt çizgiler, eklendikten sonra boşlukla değiştirilir.
version_number

int64

İsteğe bağlı. Ü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 version_number 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.

ProductStatus

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

Alanlar
destination_statuses[]

DestinationStatus

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

ItemLevelIssue

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

Timestamp

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

Timestamp

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

Timestamp

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

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 listesi (ISO 3166-1 alpha-2).
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.

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 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.
applicable_countries[]

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

ProductStructuredDescription

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

Alanlar
digital_source_type

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

ProductStructuredTitle

Algoritmik olarak (AI) 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 takip ediliyor. Maksimum uzunluk 40 karakterdir.
content

string

Başlık metni Maksimum uzunluk 150 karakterdir

ProductWeight

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

Alanlar
value

double

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.

Alanlar
price

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

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

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

int64

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

int64

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

int64

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

int64

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.

ShippingDimension

Ürünün Kargo Boyutu.

Alanlar
value

double

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

string

Değer birimi.

ShippingWeight

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

Alanlar
value

double

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

string

Değer birimi.

SubscriptionCost

Ürünün SubscriptionMaliyeti.

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

Vergi

Ürünün Vergisi.

Alanlar
rate

double

Öğ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.
tax_ship

bool

Kargo üzerinden vergi alınıyorsa doğru değerine ayarlanır.
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ığı. 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*.

UnitPricingBaseMeasure

Ürünün UnitPricingBaseMeasure değeri.

Alanlar
value

int64

Birim fiyatın paydası.
unit

string

Paydanın birimi.

UnitPricingMeasure

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

Alanlar
value

double

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

string

Ölçü birimi.