XML Şeması

Bu bölüm, satıcı yorumu veri feed'i için kullanılan XML şemasını şifreler.

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

Açıklama

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

Özellikler

Ad Biçim Yineleme sayısı Açıklama
xmlns xs:dize Gerekli (1) Lütfen aşağıdaki değeri sabit kodlayın:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:dize Gerekli (1) Lütfen aşağıdaki değeri sabit kodlayın:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:dize Gerekli (1) Lütfen aşağıdaki değeri sabitleyerek URL'ler arasında boş 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çeriyor:

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

Şunu içeriyor:

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

<merchant>

Açıklama

Her <merchant> öğesi bir satıcı hakkında bilgi ve yorum içerir.

Özellikler

Ad Biçim Yineleme sayısı Açıklama
id Kimlik Gerekli (1) Tüm feed'lerde benzersiz ve kararlı olmalıdır. Başka bir deyişle, bugün ve 90 gün önceki bir feed aynı satıcıyı ifade ediyorsa aynı kimliğe sahip olmaları gerekir.

Örnek

<merchant id="2739">

Şunu içeriyor:

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

Ad Biçim Yineleme sayısı Açıklama
name Boş Olmayan Dize Gerekli (1) Satıcı tarafından okunabilir görünen ad.
merchant_url xs:herhangi birURI Gerekli (1) Satıcının ana web sitesinin URL'si.
Bu değer için yönlendirme URL'si kullanmayın. Diğer bir deyişle, değer doğrudan satıcının sitesini işaret etmelidir.

Örnek: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:herhangi birURI Gerekli (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 Saat Dilimi ileTarihSaati Gerekli (1) Satıcının oluşturulduğu tarih/saat. Bu, hiçbir zaman değişmemelidir.
last_update_timestamp Saat Dilimi ileTarihSaati Gerekli (1) Satıcının son güncellendiği tarih/saat. <merchant> öğesindeki belirli bir satıcı kimliği için alanlardan herhangi biri güncellenirse bu değer de değişmelidir.

<deleted_merchants>

Açıklama

Silinmiş satıcıların kapsayıcısı.

Şunu içeriyor:

Ad Biçim Yineleme sayısı Açıklama
deleted_merchant -- Gerekli (1‐n) Silinen tek bir satıcıyla ilgili öğeler içerir.

<deleted_merchant>

Açıklama

Silinmiş satıcı.

Özellikler

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

Şunu içeriyor:

Ad Biçim Yineleme sayısı Açıklama
last_update_timestamp Saat Dilimi ileTarihSaati Gerekli (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ı.

Şunu içeriyor:

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

<review>

Açıklama

Yorumla ilgili ayrıntılar için kapsayıcı.

Özellikler

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

Örnek: 

<review id=132739 mid=1234>
mid Kimlik Gerekli (1) Bu yorumun ait olduğu satıcının tanımlayıcısı.

Şunu içeriyor:

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

Ad Biçim Yineleme sayısı Açıklama
reviewer_name Boş Olmayan Dize İsteğe bağlı (0‐1) Yorumun yazarının yazarın gösterilmesi şartıyla, yorumun yazarının görünen adı. Anonim yorumlar bu alanı içermemelidir.

Örnek: 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp Saat Dilimi ileTarihSaati Gerekli (1) Yorumun kullanıcı tarafından gönderildiği tarih/saat. Bu, hiçbir zaman değişmemelidir.

Örnek: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp Saat Dilimi ileTarihSaati Gerekli (1) <review> öğesindeki bilginin en son değiştirildiği saat/tarih. <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 Gerekli (1) Yorumcunun ülkesi. Kullanılabiliyorsa bu, ürünün gönderildiği veya hizmetin sunulduğu ülkedir. Aksi takdirde, yorumu oluştururken yorumcunun bulunduğu ülkeyi kullanın. Ülke kodu ISO 3166-1 alfa-2 biçiminde olmalıdır.

Örnek: 

  <country_code>
    US
  </country_code>
title xs:dize İsteğe bağlı (0‐1) Yorumun başlığı. Başlık, içinde HTML etiketi bulunmayan düz metin biçiminde olmalıdır.

Örnek: 

  <title>
    Great prices
  </title>
content xs:dize Gerekli (1) Yorumun içeriği. Bu, kullanıcı tarafından sağlanan serbest biçimli metin olmalı ve kısaltılmamalıdır. İçerik, HTML etiketi olmayan düz metin biçiminde olmalıdır. Örneğin, satır sonu, <br> etiketiyle değil, satır feed karakteriyle temsil edilmelidir. Farklı sorulara birden fazla yanıt verilirse tüm yanıtların, minimum düzeyde anlam içerecek şekilde eklenmesi gerekir. Soruların cevaplanmamış olarak bırakılması durumunda 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 -- Gerekli (1) Yorumcunun satıcı puanları için kapsayıcı öğesi. <overall> öğesi için puan yoksa <overall> öğesi gerekli olduğundan ve bu yorum olmadan yorum kabul edilmez. Bu nedenle, ilişkili yorumun tamamı feed'den hariç tutulmalıdır.
collection_method CollectionMethodType Gerekli (1) Yorumu toplamak için kullanılan yöntem. Değer aşağıdakilerden biri olmalıdır:
  • İstenmeyen: Kullanıcı, yorumu gönderdiğinde belirli bir isteğe yanıt vermedi.
  • Point_of_sale: Kullanıcı, sipariş verdiğinde talebi kabul ederek yorumu göndermiştir.
  • after_fulfillment: Kullanıcı, kullanıcının siparişinin yerine getirilmesinin ardından bir talep üzerine yorumu gönderdi.

Örnek: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Açıklama

Yorumcunun satıcı puanlarını içerir. <overall> öğesi için puan yoksa <overall> öğesi gerekli olduğundan ve bu yorum olmadan yorum kabul edilmez. Bu nedenle, ilişkili yorumun tamamı feed'den hariç tutulmalıdır.

Şunu içeriyor:

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

Ad Biçim Yineleme sayısı Açıklama
overall Puan Aralığı Gerekli (1) Yorumcunun satıcı için genel puanı.

Örnek: 

  <overall min="1" max="10">9</overall>
customer_service Puan Aralığı İsteğe bağlı (0‐1) Yorumcunun bu satıcı için müşteri hizmetleri kalitesi puanı.

Örnek: 

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

<deleted_reviews>

Açıklama

Silinen yorumların kapsayıcısı.

Şunu içeriyor:

Ad Biçim Yineleme sayısı Açıklama
deleted_review -- Gerekli (1‐n) Silinen tek bir yorumla ilgili öğeleri içerir.

<deleted_review>

Açıklama

Silineni inceleyin.

Özellikler

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

Şunu içeriyor:

Ad Biçim Yineleme sayısı Açıklama
last_update_timestamp Saat Dilimi ileTarihSaati Gerekli (1) Bir 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>