XML Şema Referansı

Google ürün yorumu feed'lerinin XML şeması, XML feed'inizin kabul edilebilir yapısını tanımlar. XML şemaları .xsd dosya uzantısını kullanır. DTD dosyaları gibi, XML şeması da bir XML belgesinde görünebilecek öğeleri ve özellikleri tanımlar.

XML şemaları hakkında daha fazla bilgiyi bu XML Şeması Primer'dan edinebilirsiniz.

Ürün yorumu feed'leri için XML şeması burada yayınlanmıştır: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Bu şema tarafından tanımlanan feed yapısının açıklaması aşağıda verilmiştir. Bu açıklamada, xs: önekine sahip tür adları, http://www.w3.org/2001/XMLSchema XML ad alanındaki yerleşik XML şema türlerini ifade eder.

Sistemimiz her zaman tam bir feed bekler. Daha önce gönderilen ancak sonraki tam feed'inize dahil edilmeyen yorumlar silinir. Bu nedenle, feed'inizi gönderirken her zaman tüm yorumlarınızı göndermeniz gerekir.

Üst düzey <feed> öğesi

<feed> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<version> Zorunlu (1) xs:string Ürün yorumu feed şemasının hangi sürümünün kullanıldığını gösterir. Şu anda yalnızca <version>2.4</version> desteklenmektedir.
<aggregator> İsteğe bağlı (1) aggregatorType Yayıncılar, yorumları yönetmek ve feed'leri sağlamak için yorum toplayıcı kullanabilir. Bu öğe, toplayıcı kullanımını gösterir ve toplayıcı hakkında bilgiler içerir.
<publisher> Zorunlu (1) publisherType Yayıncı hakkındaki bilgiler (perakendeci, üretici, yorum hizmeti şirketi veya ürün yorumları yayınlayan herhangi bir tüzel kişi olabilir).
<reviews> İsteğe bağlı (1) xs:sequence Ürün incelemelerini içerir.

<feed>, feed'de kullanılan öğelerle ilgili benzersizlik kısıtlamalarını tanımlar.

Alt öğeler

<aggregator>

Yayıncılar, yorumları yönetmek ve feed'leri sağlamak için yorum toplayıcı kullanabilir. Bu öğe, bir toplayıcının kullanımını gösterir ve toplayıcı hakkında bilgi içerir. <aggregator> öğesi, bu öğeleri listelenen sırayla içerir.

Öğe Tekrar Tür Açıklama
<name> Zorunlu (1) nonEmptyStringType Ürün yorumlarının toplayıcısının adı.

<publisher>

Yayıncıyla ilgili bilgiler (perakendeci, üretici, yorum hizmeti şirketi veya ürün yorumları yayınlayan herhangi bir tüzel kişi olabilir). <publisher> öğesi, bu öğeleri listelendikleri sırayla içerir.

Öğe Tekrar Tür Açıklama
<name> Zorunlu (1) nonEmptyStringType Ürün yorumlarının yayıncısının adı.
<favicon> İsteğe bağlı (1) httpUrlType Yayıncının şirket favicon'unun bağlantısı. Resim boyutları, favicon boyutu olan 16x16 piksel olmalıdır. Resim biçimi GIF, JPG veya PNG olmalıdır.

<reviews>

Ürün yorumlarını içerir. <reviews> öğesi, bu öğeleri listelenen sırayla içerir.

Öğe Tekrar Tür Açıklama
<review> Zorunlu (1-sınırsız) reviewType Tek bir benzersiz ürün yorumu. Bir yorum yayıncının envanterindeki birden fazla ürünle ilgiliyse yorumu bir kez belirtin ve <product> öğesine birden fazla <products> öğesi ekleyin.

<review>

Tek bir benzersiz ürün yorumu. Bir yorum, yayıncının envanterindeki birden fazla ürünle ilgiliyse yorumu bir kez belirtin ve <products> öğesine birden fazla <product> öğesi ekleyin.<review> öğesi, bu öğeleri listelenen sırayla içerir.

Öğe Tekrar Tür Açıklama
<review_id> Zorunlu (1) nonEmptyStringType Yayıncının sistemindeki ürün yorumuna ait kalıcı ve benzersiz tanımlayıcı.
<reviewer> Zorunlu (1) reviewerType Ürün yorumunun yazarı.
<is_verified_purchase> İsteğe bağlı (1) xs:boolean Yorum yapan kullanıcının ürünü satın aldığı doğrulanıp doğrulanmadığını gösterir.
<is_incentivized_review> İsteğe bağlı (1) xs:boolean Yorumcunun ürünü yorumlaması için teşvik edilip edilmediğini gösterir.
<review_timestamp> Zorunlu (1) xs:dateTime

Yorumun yazıldığı zamanı gösteren zaman damgası.

Örnekler:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> İsteğe bağlı (1) nonEmptyStringType Yorumun başlığı.
<content> Zorunlu (1) nonEmptyStringType Yorumun içeriği.
<review_language> İsteğe bağlı (1) xs:string Yorumun dili (BCP 47).
<review_country> İsteğe bağlı (1) xs:string Yorum yapan kullanıcının ülke kodu (ISO 3166-1).
<pros> İsteğe bağlı (1) xs:sequence Yorumcunun görüşüne göre avantajları içerir. Yorumcu tarafından yazılmadığı sürece "artı:" gibi şablon metinleri atlayın.
<cons> İsteğe bağlı (1) xs:sequence İncelemeyi yapan kişinin görüşüne göre dezavantajları içerir. Yorumcu tarafından yazılmadığı sürece "con:" gibi standart metinleri atlayın.
<reviewer_images> İsteğe bağlı (1) xs:sequence Yorumcu tarafından sağlanan ürün resimlerinin bağlantılarını içerir.
<review_url> Zorunlu (1) reviewUrlType Yorum açılış sayfasının URL'si.
<ratings> Zorunlu (1) xs:sequence Yorumla ilişkili puanları içerir.
<products> Zorunlu (1) xs:sequence Yorumla ilişkili ürünleri içerir.
<is_spam> İsteğe bağlı (1) xs:boolean Yorumun yayıncının sisteminde spam olarak işaretlenip işaretlenmediğini gösterir.
<collection_method> İsteğe bağlı (1) collectionMethodType

Yorumu toplamak için kullanılan yöntem. Değer aşağıdakilerden biri olmalıdır:

unsolicited
Kullanıcı, kendisinden talep edilmeden yorum göndermiş.
post_fulfillment
Kullanıcı, siparişi karşılandıktan sonra kendisinden talep edildiği için yorum göndermiş.
<transaction_id> İsteğe bağlı (1) nonEmptyStringType Yayıncının sistemindeki yorumla ilişkilendirilmiş işleme ait kalıcı ve benzersiz tanımlayıcı. Bu kimlik, aynı işlemle birden fazla yorumun ilişkilendirildiğini belirtmek için kullanılabilir.

<reviewer>

Ürün yorumunun yazarı. <reviewer> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<name> Zorunlu (1) reviewerNameType

Yorumu yazan kişinin adı.

Örnek:

<name>Jane</name>
<reviewer_id> İsteğe bağlı (1) nonEmptyStringType

Yorumun yazarının yayıncının sistemindeki kalıcı ve benzersiz tanımlayıcısı.

Örnek:

<reviewer_id>14295</reviewer_id>

<name>

Yorumu yazan kişinin adı. <name> öğesi, nonEmptyStringType öğesinin bir uzantısıdır ve yorumcunun adını veya takma adını içerir. <name> öğesi şu özellikleri içerir.

Özellik Tekrar Tür Açıklama
is_anonymous İsteğe bağlı xs:boolean

Yorumcunun anonim olup olmadığını gösterir.

Örnek:

<name is_anonymous="true">Anonymous</name>

<pros>

Yorumcunun görüşüne göre avantajları içerir. <pros> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<pro> Zorunlu (1-sınırsız) nonEmptyStringType

İncelemeyi yapan kişinin görüşüne dayalı bireysel bir avantaj. Avantajlar, gösterildikleri sırayla listelenmelidir. Yorumcu tarafından yazılmadığı sürece "artı:" gibi şablon metinleri atlayın.

Örnek:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

İncelemeyi yapan kişinin görüşüne göre dezavantajları içerir. <cons> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<con> Zorunlu (1-sınırsız) nonEmptyStringType

İncelemeyi yapan kişinin görüşüne dayalı bireysel bir eksidir. Eksiler, gösterildikleri sırayla listelenmelidir. Yorumcu tarafından yazılmadığı sürece "con:" gibi şablon metinleri atlayın.

Örnek:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

Yorum açılış sayfasının URL'si. <review_url> öğesi, httpUrlType öğesinin bir uzantısıdır ve yorumun açılış sayfasına bağlantı içerir. <review_url> öğesi şu özellikleri içerir.

Özellik Tekrar Tür Açıklama
type Zorunlu xs:string

Tür aşağıdakilerden biri olmalıdır:

singleton
Yorum sayfasında yalnızca bu tek yorum var.
group
Yorum sayfasında, bu yorumun da yer aldığı bir grup yorum var.

Örnek:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Yorumcu tarafından sağlanan ürün resimlerini içerir. <reviewer_images> etiketi çok sayıda <reviewer_image> öğesi içeriyor.

Öğe Tekrar Tür Açıklama
<reviewer_image> Zorunlu (1-sınırsız) reviewImageType

Yorumu yazan kişi tarafından oluşturulan, yorumlanan ürünün resmi.

<reviewer_image>

Tek bir yorum resmi öğesi.

Öğe Tekrar Tür Açıklama
<url> Zorunlu (1) httpUrlType

Yorum yazarı tarafından oluşturulan, yorumlanan ürünün resminin URL'si. URL, bir resim dosyası uzantısıyla bitmek zorunda değildir.

Örnek:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

Yorumla ilişkili puanları içerir. <ratings> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<overall> Zorunlu (1) ratingType Yorumcunun ürüne verdiği genel puan.

<overall>

Yorumcunun ürüne verdiği genel puan. <overall> öğesi bir xs:decimal simpleType öğesini genişletir ve yorumcu tarafından atanan puanı yakalar. Değer, min ve max özellikleri tarafından tanımlanan kapsayıcı aralıkta olmalıdır. <overall> öğesi şu özellikleri içerir.

Özellik Tekrar Tür Açıklama
min Zorunlu xs:integer Puan için olası en düşük sayı. Bu, mümkün olan en kötü puan olmalı ve puan verilmemiş bir değer olmamalıdır.
max Zorunlu xs:integer Puan için olası maksimum sayı. max özelliğinin değeri, min özelliğinin değerinden büyük olmalıdır.

<products>

Yorumla ilişkili ürünleri içerir. <products> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<product> Zorunlu (1-sınırsız) productType Yorumla ilişkili bir ürün.

<product>

Yorumla ilişkili bir ürün. <product> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<product_ids> İsteğe bağlı (1) productIdsType Bir ürünle ilişkili tanımlayıcılar.
<product_name> İsteğe bağlı (1) nonEmptyStringType Ürünün açıklayıcı adı.
<product_url> Zorunlu (1) httpUrlType Ürünün URL'si. Yorum URL'si ile ürün URL'si aynıysa bu URL, <review_url> öğesiyle aynı değere sahip olabilir.

<product_ids>

Bir ürünle ilişkili tanımlayıcılar. <product_ids> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<gtins> Zorunlu (Bilinen bir GTIN'si olan ürünlerle ilişkili tüm yorumlar için)

Diğer tüm yorumlar için isteğe bağlıdır (1)		 gtinsType Bir ürünle ilişkili GTIN'ler (Global Ticari Öğe Numaraları) içerir. GTIN'lerin alt türleri (ör. UPC, EAN, ISBN, JAN) desteklenir.
<mpns> Zorunlu (Bilinen bir MPN'ye sahip ürünlerle ilişkili tüm yorumlar için)

Diğer tüm yorumlar için isteğe bağlıdır (1)		 mpnsType Bir ürünle ilişkili MPN'ler (üretici parça numaraları) içerir.
<skus> Zorunlu (Bilinen bir SKU'ya sahip ürünlerle ilişkili tüm yorumlar için)

Diğer tüm yorumlar için isteğe bağlıdır (1)		 skusType Bir ürünle ilişkili SKU'ları (stok tutma birimleri) içerir. Bu değer genellikle ürün feed'indeki ürün teklifi kimliğiyle eşleşir.
<brands> Zorunlu (Bilinen bir markası olan ürünlerle ilişkili tüm yorumlar için)

Diğer tüm yorumlar için isteğe bağlıdır (1)		 brandsType Bir ürünle ilişkili marka adlarını içerir.
<asins> İsteğe bağlı (1) asinsType Bir ürünle ilişkili ASIN'leri (Amazon Standart Kimlik Numaraları) içerir.

<gtins>

Bir ürünle ilişkili GTIN'ler (Global Ticari Öğe Numaraları) içerir. <gtins> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<gtin> Zorunlu (1-sınırsız) nonEmptyStringType Ürünün global ticari öğe numarası. GTIN'lerin alt türleri (ör. UPC, EAN, ISBN, JAN) desteklenir.

<mpns>

Bir ürünle ilişkili MPN'ler (üretici parça numaraları) içerir. <mpns> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<mpn> Zorunlu (1-sınırsız) nonEmptyStringType Ürünün üretici parça numarası.

<skus>

Bir ürünle ilişkili SKU'ları (stok tutma birimleri) içerir. <skus> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<sku> Zorunlu (1-sınırsız) nonEmptyStringType Yayıncının envanterindeki ürünün stok tutma birimi.

<brands>

Bir ürünle ilişkili marka adlarını içerir. <brands> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<brand> Zorunlu (1-sınırsız) nonEmptyStringType Ürünün marka adı.

<asins>

Bir ürünle ilişkili ASIN'leri (Amazon Standart Kimlik Numaraları) içerir. <asins> öğesi, listelenen sırayla bu öğeleri içerir.

Öğe Tekrar Tür Açıklama
<asin> Zorunlu (1-sınırsız) nonEmptyStringType Ürünün Amazon Standart Kimlik Numarası. Her ASIN 10 karakter uzunluğunda ve alfanümeriktir.