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:"" 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:
|
<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:
Ö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.
Öğ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. |