XML Şeması

Bu bölümde, satıcı yorumu verileri feed'i için kullanılan XML şeması açıklanmaktadır.

Üst düzey öğe: <feed>

Açıklama

Feed'deki diğer tüm öğeleri içeren en üstteki kapsayıcı öğe.

Özellikler

Adı Biçim Yineleme sayısı Açıklama
xmlns xs:string Zorunlu (1) Lütfen aşağıdaki değeri sabit kodlayın:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Zorunlu (1) Lütfen aşağıdaki değeri sabit kodlayın:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Zorunlu (1) Lütfen aşağıdaki değeri sabit kodlayın ve URL'ler arasında tek bir boşluk bırakın:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Örnek

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
merchants       -- İsteğe bağlı (0-1) <merchant> öğelerinin kapsayıcı öğesi.
deleted_merchants       -- İsteğe bağlı (0-1) <deleted_merchant> öğelerinin kapsayıcı öğesi.
reviews       -- İsteğe bağlı (0-1) <review> öğelerinin kapsayıcı öğesi.
deleted_reviews       -- İsteğe bağlı (0-1) <deleted_review> öğelerinin kapsayıcı öğesi.

<merchants>

Açıklama

<merchant> öğelerinin kapsayıcısıdır.

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
merchant       -- Zorunlu (1-n) Her satıcı için tekrarlanan öğe.

<merchant>

Açıklama

Her <merchant> öğesi, bir satıcıyla ilgili bilgileri ve yorumları içerir.

Özellikler

Adı Biçim Yineleme sayısı Açıklama
id Id Zorunlu (1) Tüm feed'lerde benzersiz ve sabit olmalıdır. Başka bir deyişle, bugün yüklenen bir feed ile 90 gün önce yüklenen bir feed aynı satıcıya aitse aynı kimliğe sahip olmalıdır.

Örnek

<merchant id="2739">

Şunu içerir:

Lütfen satıcı öğesine aşağıdaki öğeleri ekleyin.

Ad Biçim Yineleme sayısı Açıklama
name NonEmptyString Zorunlu (1) Satıcının, kullanıcılar tarafından okunabilir görünen adı.
merchant_url xs:anyURI Zorunlu (1) Satıcının ana web sitesinin URL'si.
Bu değer için yönlendirme URL'si kullanmayın. Başka bir deyişle, değer doğrudan satıcının sitesine yönlendirmelidir.

Örnek: 

<merchant_url>
  http://store.google.com
</merchant_url>

rating_url xs:anyURI Zorunlu (1) Bu satıcının yorumlarını barındıran açılış sayfasının URL'si.
Yönlendirme URL'si kullanmayın.

Örnek: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>

create_timestamp DateTimeWithTimeZone Zorunlu (1) Satıcının oluşturulduğu saat/tarih. Bu değer hiçbir zaman değişmemelidir.
last_update_timestamp DateTimeWithTimeZone Zorunlu (1) Satıcının son güncellenme tarihi/saati. <merchant> öğesindeki alanlardan herhangi biri belirli bir satıcı kimliği için güncellenirse bu değer de değişmelidir.

<deleted_merchants>

Açıklama

Silinen satıcılar için kapsayıcı.

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
deleted_merchant       -- Zorunlu (1-n) Silinmiş tek bir satıcıyla ilgili öğeler içeriyor.

<deleted_merchant>

Açıklama

Silinen satıcı.

Özellikler

Adı Biçim Yineleme sayısı Açıklama
id Id Zorunlu (1) Feed'den silinmesi gereken bir satıcının kimliğini belirtir. Kimlik, önceki feed dosyalarındaki bir <merchant> öğesinin id özelliğiyle eşleşmelidir.

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
last_update_timestamp DateTimeWithTimeZone Zorunlu (1) Bir satıcının sistemden kaldırıldığı tarih/saat.

Örnek: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

Örnek

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

Açıklama

<review> öğelerinin kapsayıcısıdır.

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
review       -- Zorunlu (1-n) Her yorum için tekrarlanan öğe.

<review>

Açıklama

Yorumla ilgili ayrıntıların bulunduğu kapsayıcı.

Özellikler

Adı Biçim Yineleme sayısı Açıklama
id Id Zorunlu (1) Sisteminizdeki bir yorumun tanımlayıcısı. Tüm feed'lerde benzersiz ve sabit olmalıdır.

Örnek: 

<review id=132739 mid=1234>

mid Id Zorunlu (1) Bu yorumun yapıldığı satıcının tanımlayıcısı.

Şunu içerir:

Lütfen inceleme öğesine aşağıdaki öğeleri ekleyin.

Ad Biçim Yineleme sayısı Açıklama
reviewer_name NonEmptyString İsteğe bağlı (0-1) Yorumun yazarı adlandırılmış olmalıdır. Bu durumda, yorumun yazarının görünen adı. Anonim yorumlarda bu alan yer almamalıdır.

Örnek: 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp DateTimeWithTimeZone Zorunlu (1) Yorumun kullanıcı tarafından gönderildiği saat/tarih. Bu değer hiçbir zaman değişmemelidir.

Örnek: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>

last_update_timestamp DateTimeWithTimeZone Zorunlu (1) <review> öğesindeki bilgilerin en son değiştiği tarih/saat. <review> öğesindeki alanlardan herhangi biri belirli bir yorum kimliği için güncellenirse bu değer de değişmelidir.

Örnek: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

country_code CountryCode Zorunlu (1) Yorum yazan kullanıcının ülkesi. Varsa ürünün kargolandığı veya hizmetin sağlandığı ülkedir. Aksi takdirde, yorum sahibinin yorumu yazdığında bulunduğu ülkeyi kullanın. Ülke kodu, ISO 3166-1 alpha-2 biçiminde olmalıdır.

Örnek: 

  <country_code>
    US
  </country_code>

title xs:string İsteğe bağlı (0-1) Yorumun başlığı. Başlık, HTML etiketleri içermeyen düz metin olmalıdır.

Örnek: 

  <title>
    Great prices
  </title>

content xs:string Zorunlu (1) Yorumun içeriği. Bu, kullanıcı tarafından sağlanan herhangi bir serbest biçimli metin olmalı ve kısaltılmamalıdır. İçerik, HTML etiketleri içermeyen düz metin olmalıdır. Örneğin, satır sonu <br> etiketiyle değil, satır besleme karakteriyle gösterilmelidir. Farklı sorulara birden fazla yanıt veriliyorsa tüm yanıtlar, anlamlı olmaları için gereken minimum bağlamla birlikte eklenmelidir. Sorular yanıtlanmamışsa bağlam sağlanmamalıdır.

Örnek: 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

Örnek: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings           -- Zorunlu (1) Yorumcunun satıcıya verdiği puanları içeren kapsayıcı öğe. <overall> öğesi için puan yoksa <overall> öğesi zorunlu olduğundan ve puan olmadan inceleme kabul edilmeyeceğinden, ilişkili incelemenin tamamı feed'den çıkarılmalıdır.
collection_method CollectionMethodType Zorunlu (1) Yorumu toplamak için kullanılan yöntem. Değer aşağıdakilerden biri olmalıdır:
  • talep edilmeden: Kullanıcı, kendisinden talep edilmeden yorum göndermiş.
  • point_of_sale: Kullanıcı, sipariş verdikten sonra kendisinden talep edildiği için yorum göndermiş.
  • after_fulfillment: Kullanıcı, siparişi karşılandıktan sonra kendisinden talep edildiği için yorum göndermiş.

Örnek: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Açıklama

Yorum yapan kullanıcının satıcıya verdiği puanları içerir. <overall> öğesi için puan yoksa, <overall> öğesi zorunlu olduğundan ve bu öğe olmadan yorum kabul edilmeyeceğinden, ilişkili yorumun tamamı feed'den çıkarılmalıdır.

Şunu içerir:

Lütfen derecelendirme öğesine aşağıdaki öğeleri ekleyin.

Ad Biçim Yineleme sayısı Açıklama
overall RatingRange Zorunlu (1) Yorumcunun bir satıcıya verdiği genel puan.

Örnek: 

  <overall min="1" max="10">9</overall>

customer_service RatingRange İsteğe bağlı (0-1) Yorumcunun bu satıcının müşteri hizmeti kalitesine verdiği puan.

Örnek: 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

Açıklama

Silinen yorumların bulunduğu kapsayıcı.

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
deleted_review       -- Zorunlu (1-n) Silinmiş tek bir yorumla ilgili öğeler içerir.

<deleted_review>

Açıklama

Silinen yorum

Özellikler

Adı Biçim Yineleme sayısı Açıklama
id Id Zorunlu (1) Feed'den silinmesi gereken bir yorumun kimliğini belirtir. Kimlik, herhangi bir feed dosyasındaki <review> öğesinin kimlik özelliğiyle eşleşmelidir.

Şunu içerir:

Ad Biçim Yineleme sayısı Açıklama
last_update_timestamp DateTimeWithTimeZone Zorunlu (1) Yorumun sistemden kaldırıldığı zaman.

Örnek: 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

Örnek

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>