XML Şema Referansı

Kitap: /product-review-feeds/_book.yaml

Title: XML Şeması Referansı

Google Ürün İnceleme Feed'leri için XML şeması, XML feed'inizin kabul edilebilir yapısını tanımlar. XML şemaları, .xsd dosya uzantısını kullanır. DTD dosyaları gibi, bir XML şeması da XML dokümanında görünebilecek öğeleri ve özellikleri tanımlar.

Bu XML Şeması Astarı sayfasından XML şemaları hakkında daha fazla bilgi edinebilirsiniz.

Ürün yorumu feed'leri için XML şeması burada yayınlanır: http://www.google.com/shopping/reviews/schema/product/2.3/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ında bulunan yerleşik XML şeması türlerine işaret eder.

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

Üst düzey <feed> öğesi

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

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

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

Alt Öğeler

<aggregator>

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

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

<publisher>

Yayıncı, perakendeci, üretici, yorum hizmeti şirketi veya ürün yorumları yayınlayan herhangi bir tüzel kişi olabilecek bilgilerdir.<publisher> öğesi, bu öğeleri listelenen sırayla içerir.

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

<reviews>

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

Öğe Tahakkuk Tür Açıklama
<review> Zorunlu (1-sınırsız) reviewType Benzersiz bir ürün yorumu. Yorum, yayıncının envanterinde birden fazla ürünle ilgiliyse incelemeyi bir kez belirtin ve <products> öğesine birden fazla <product> öğesi ekleyin.

<review>

Benzersiz bir ürün yorumu. Yorum, yayıncının envanterinde birden fazla ürünle ilgiliyse yorumu bir kez belirtin ve <products> öğesine birden fazla <product> öğesi ekleyin.<review> öğesi, bu öğeleri listelenen sırada içerir.

Öğe Tahakkuk Tür Açıklama
<review_id> İsteğe bağlı (1) nonEmptyStringType Yayıncının sistemindeki ürün incelemesi için kalıcı, benzersiz tanımlayıcı.
<reviewer> Gerekli (1) reviewerType Ürün yorumunun yazarı.
<review_timestamp> Gerekli (1) xs:dateTime

Yorumun ne zaman yazıldığını 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> Gerekli (1) nonEmptyStringType Yorumun içeriği.
<pros> İsteğe bağlı (1) xs:sequence Yorumcunun düşüncesine göre profesyonelleri içerir. Yorumcu tarafından yazılmadığı sürece "&";pro:" gibi ortak metin kullanmayın.
<cons> İsteğe bağlı (1) xs:sequence İnceleyenin görüşlerine dayalı olarak dezavantajları içerir. İncelemeci tarafından yazılmadığı sürece "con:&quot" gibi ortak metin kullanmayı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> Gerekli (1) reviewUrlType Yorum açılış sayfasının URL'si.
<ratings> Gerekli (1) xs:sequence Yorumla ilişkilendirilen puanları içerir.
<products> Gerekli (1) xs:sequence Yorumla ilişkilendirilen ürünleri içerir.
<is_spam> İsteğe bağlı (1) xs:boolean Yorumun, yayıncı sisteminde spam olarak işaretlenip işaretlenmediğini belirtir.
<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ı, yorumu gönderdiğinde belirli bir isteğe yanıt vermemişti.
post_fulfillment
Kullanıcı, siparişinin yerine getirilmesinin ardından isteği ileterek yorumu gönderdi.
<transaction_id> İsteğe bağlı (1) nonEmptyStringType Yayıncının sistemindeki yorumla ilişkilendirilen işlem için kalıcı ve benzersiz bir 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, bu öğeleri listelenen sırada içerir.

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

Yorumu yazan kişinin adı.

Örnek:

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

Yayıncının sisteminde yorumun yazarı için kalıcı ve benzersiz bir tanımlayıcı.

Örnek:

<reviewer_id>14295</reviewer_id>

<name>

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

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

Yorumcunun anonim olup olmadığını belirtir.

Örnek:

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

<pros>

Yorumcunun düşüncesine göre profesyonelleri içerir. <pros> öğesi, bu öğeleri listelenen sırada içerir.

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

Yorumcunun fikrine dayalı bireysel bir profesyonel. Sağlayıcılar, gösterildikleri sırayla listelenmelidir. Yorumcu tarafından yazılmadığı sürece "&t;pro:" gibi ortak metin kullanmayın.

Örnek:

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

<cons>

İnceleyenin görüşlerine dayalı olarak dezavantajları içerir. <cons> öğesi, bu öğeleri listelenen sırada içerir.

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

Yorumcunun fikrine dayalı bireysel bir şikayet. Eksileri, gösterildikleri sırayla listelenmelidir. Yorumcu tarafından yazılmadığı sürece "con:" gibi ortak metin kullanmayın.

Örnek:

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

<review_url>

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

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

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

singleton
İnceleme sayfası yalnızca bu yorumu içerir.
group
Yorum sayfası, bu yorumu içeren bir grup yorumu içerir.

Örnek:

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

<reviewer_images>

Yorumcu tarafından sağlanan ürünlerin resimlerini içerir. <reviewer_images> etiketi birçok <reviewer_image> öğesi içerir.

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

İncelenen ürünün, yazar tarafından oluşturulan resmi.

<reviewer_image>

Tek bir yorum resmi öğesi.

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

İncelenen ürünün, yorum yazarı tarafından oluşturulan resminin URL'si. URL'nin resim dosyası uzantısıyla bitmesi gerekmez.

Ö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şkilendirilen puanları içerir. <ratings> öğesi, bu öğeleri listelenen sırada içerir.

Öğe Tahakkuk Tür Açıklama
<overall> Gerekli (1) ratingType Yorumcunun ürünün genel puanı.

<overall>

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

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

<products>

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

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

<product>

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

Öğe Tahakkuk Tür Açıklama
<product_ids> İsteğe bağlı (1) productIdsType Bir ürünle ilişkilendirilmiş tanımlayıcılar.
<product_name> İsteğe bağlı (1) nonEmptyStringType Bir ürünün açıklayıcı adı.
<product_url> Gerekli (1) httpUrlType Ürünün URL'si. İnceleme 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şkilendirilmiş tanımlayıcılar. <product_ids> öğesi, bu öğeleri listelenen sırada içerir.

Öğe Tahakkuk Tür Açıklama
<gtins> Gerekli (Tam yorum eşleşmesini sağlamak için bilinen bir GTIN'ye sahip ürünlerle ilişkili tüm yorumlarda)

Diğer tüm yorumlar için isteğe bağlı (kesinlikle önerilir) (1)
gtinsType Bir ürünle ilişkili GTIN'leri (global ticari öğe numaraları) içerir.
<mpns> Gerekli (Yorumla ilişkilendirilmiş ürüne atanmış bir GTIN yoksa yorum eşleşmesini kolaylaştırmak için MPN dahil edilmelidir. Marka ile gönderilmelidir)

Diğer tüm yorumlar için isteğe bağlıdır (1)
mpnsType Bir ürünle ilişkili MPN'leri (üretici parça numaraları) içerir.
<skus> Gerekli (Yorumla ilişkili ürüne atanmış bir GTIN veya MPN yoksa SKU, yorum eşleştirmeyi kolaylaştırmak için dahil edilmelidir. Marka ile gönderilmelidir)

Diğer tüm yorumlar için isteğe bağlı (1)
skusType Bir ürünle ilişkili SKU'ları (stokta tutma birimleri) içerir. Çoğu zaman bu, ürün feed'indeki ürün Teklif Kimliği ile eşleşir.
<brands> Gerekli (Yorumla ilişkili ürüne atanmış bir GTIN yoksa marka, yorum eşleşmesini kolaylaştırmak için dahil edilmelidir.) MPN ile gönderilmelidir)

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'ler (Amazon Standart Kimlik Numaraları) içerir.

<gtins>

Bir ürünle ilişkili GTIN'leri (global ticari öğe numaraları) içerir. <gtins> öğesi, bu öğeleri listelenen sırada içerir.

Öğe Tahakkuk Tür Açıklama
<gtin> Zorunlu (1-sınırsız) nonEmptyStringType Ürünün global ticari öğe numarası.

<mpns>

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

Öğe Tahakkuk 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ı (stokta tutma birimleri) içerir. <skus> öğesi, bu öğeleri listelenen sırada içerir.

Öğe Tahakkuk 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, bu öğeleri listelenen sırada içerir.

Öğe Tahakkuk 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. öğesi, bu öğeleri listelenen sırada içerir.

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