Schemat XML

W tej sekcji opisano schemat XML pliku danych z opiniami o sprzedawcach.

Element najwyższego poziomu: <feed>

Opis

Górny element kontenera, w którym znajdują się wszystkie pozostałe elementy pliku danych.

Atrybuty

Nazwa Format Wystąpienia Opis
xmlns xs:ciąg Wymagane (1) Wpisz na stałe tę wartość:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:ciąg Wymagane (1) Wpisz na stałe tę wartość:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:ciąg Wymagane (1) Wpisz tę wartość na stałe, pozostawiając pojedyncze puste miejsce między adresami URL:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Przykład

<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">

Zawiera

Nazwa Format Wystąpienia Opis
merchants -- Opcjonalnie (0–1) Element kontenera dla elementów <merchant>.
deleted_merchants -- Opcjonalnie (0–1) Element kontenera dla elementów <deleted_merchant>.
reviews -- Opcjonalnie (0–1) Element kontenera dla elementów <review>.
deleted_reviews -- Opcjonalnie (0–1) Element kontenera dla elementów <deleted_review>.

<merchants>

Opis

Kontener elementów <merchant>.

Zawiera

Nazwa Format Wystąpienia Opis
merchant -- Wymagane (1–n) Element powtórzony dla każdego sprzedawcy.

<merchant>

Opis

Każdy element <merchant> zawiera informacje i opinie dotyczące jednego sprzedawcy.

Atrybuty

Nazwa Format Wystąpienia Opis
id Identyfikator Wymagane (1) Musi być unikalny i stabilny we wszystkich plikach danych. Innymi słowy, jeśli plik danych utworzony dzisiaj i 90 dni temu dotyczą tego samego sprzedawcy, muszą mieć ten sam identyfikator.

Przykład

<merchant id="2739">

Zawiera

Dodaj te elementy do elementu sprzedawcy.

Nazwa Format Wystąpienia Opis
name Niepusty ciąg znaków Wymagane (1) Czytelna nazwa wyświetlana sprzedawcy.
merchant_url xs:anyURI Wymagane (1) Adres URL głównej witryny sprzedawcy.
Dla tej wartości nie używaj adresu URL przekierowania. Innymi słowy, wartość powinna wskazywać bezpośrednio stronę internetową sprzedawcy.

Przykład: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:anyURI Wymagane (1) Adres URL strony docelowej zawierającej opinie tego sprzedawcy.
Nie używaj adresu URL przekierowania.

Przykład: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>
create_timestamp DateTimeWithTimeZone Wymagane (1) Data/data utworzenia sprzedawcy. Nie powinno to się zmienić.
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Data i godzina ostatniej aktualizacji sprzedawcy. Jeśli dowolne pole w elemencie <merchant> zostanie zaktualizowane dla danego identyfikatora sprzedawcy, ta wartość również musi się zmienić.

<deleted_merchants>

Opis

Kontener sprzedawców, którzy zostali usunięci.

Zawiera

Nazwa Format Wystąpienia Opis
deleted_merchant -- Wymagane (1–n) Zawiera elementy powiązane z 1 usuniętym sprzedawcą.

<deleted_merchant>

Opis

Sprzedawca, który został usunięty.

Atrybuty

Nazwa Format Wystąpienia Opis
id Identyfikator Wymagane (1) Określa identyfikator sprzedawcy, którego należy usunąć z pliku danych. Identyfikator musi odpowiadać atrybutowi id elementu <merchant> w dowolnym poprzednim pliku danych.

Zawiera

Nazwa Format Wystąpienia Opis
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Data/godzina usunięcia sprzedawcy z systemu.

Przykład: 

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

Przykład

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

<reviews>

Opis

Kontener elementów <review>.

Zawiera

Nazwa Format Wystąpienia Opis
review -- Wymagane (1–n) Element powtórzony w przypadku każdej opinii.

<review>

Opis

Kontener na szczegółowe informacje związane z opinią.

Atrybuty

Nazwa Format Wystąpienia Opis
id Identyfikator Wymagane (1) Identyfikator opinii w systemie. Musi być unikalny i stabilny we wszystkich plikach danych.

Przykład: 

<review id=132739 mid=1234>
mid Identyfikator Wymagane (1) Identyfikator sprzedawcy, którego dotyczy opinia.

Zawiera

W elemencie opinii umieść te elementy.

Nazwa Format Wystąpienia Opis
reviewer_name Niepusty ciąg znaków Opcjonalnie (0–1) Wyświetlana nazwa autora opinii, pod warunkiem, że widnieje w nim nazwa autora. Anonimowe opinie nie powinny zawierać tego pola.

Przykład: 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp DateTimeWithTimeZone Wymagane (1) Data i godzina przesłania opinii przez użytkownika Nie powinno to się zmienić.

Przykład: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Data i godzina ostatniej modyfikacji informacji w elemencie <review>. Jeśli dowolne pole w elemencie <review> zostanie zaktualizowane w przypadku danego identyfikatora opinii, ta wartość również musi się zmienić.

Przykład: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>
country_code Kod kraju Wymagane (1) Kraj autora opinii. Jest to kraj, do którego produkt został wysłany (lub jeśli ta usługa jest dostępna). W innym przypadku wybierz kraj, w którym jest weryfikator. Kod kraju musi być w formacie ISO 3166-1 alfa-2.

Przykład: 

  <country_code>
    US
  </country_code>
title xs:ciąg Opcjonalnie (0–1) Tytuł opinii. Tytuł powinien być zwykłym tekstem, bez tagów HTML.

Przykład: 

  <title>
    Great prices
  </title>
content xs:ciąg Wymagane (1) Treść opinii. Powinien to być dowolny dowolny tekst podany przez użytkownika i nie powinien być obcięty. Treść powinna być zwykłym tekstem, bez tagów HTML. Na przykład podział wiersza powinien być reprezentowany przez znak kanału wiersza, a nie za pomocą tagu &lt. Jeśli podasz wiele odpowiedzi na różne pytania, należy uwzględnić wszystkie z minimalnym kontekstem. Nie należy podawać kontekstu, jeśli nie ma odpowiedzi na pytania.

Przykład: 

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

Przykład: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- Wymagane (1) Element kontenera przeznaczony dla recenzenta i oceny sprzedawcy. Jeśli element <overall> nie ma oceny, należy wykluczyć z pliku danych całą powiązaną opinię, ponieważ element <overall> jest wymagany i bez niego nie zostanie zaakceptowana.
collection_method Rodzaj metody Wymagane (1) Metoda użyta do zebrania opinii. Musi to być jedna z tych wartości:
  • niezamówiona: użytkownik nie odpowiedział na konkretną prośbę o przesłanie opinii.
  • point_of_sale: użytkownik przesłał opinię w odpowiedzi na zachętę, gdy użytkownik złożył zamówienie.
  • After_fulfillment: użytkownik przesłał opinię w odpowiedzi na zapytanie po realizacji zamówienia użytkownika.

Przykład: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Opis

Zawiera ocenę recenzenta sprzedawcy. Jeśli element <overall> nie ma oceny, należy wykluczyć z pliku danych całą powiązaną opinię, ponieważ element <overall> jest wymagany i bez niego nie zostanie zaakceptowana.

Zawiera

W obiekcie ocen umieść te elementy.

Nazwa Format Wystąpienia Opis
overall ZakresZakres Wymagane (1) Ogólna ocena weryfikatora sprzedawcy.

Przykład: 

  <overall min="1" max="10">9</overall>
customer_service ZakresZakres Opcjonalnie (0–1) Ocena jakości obsługi klienta przez sprzedawcę.

Przykład: 

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

<deleted_reviews>

Opis

Kontener na usunięte opinie.

Zawiera

Nazwa Format Wystąpienia Opis
deleted_review -- Wymagane (1–n) Zawiera elementy powiązane z jedną usuniętą opinią.

<deleted_review>

Opis

Sprawdź, która została usunięta.

Atrybuty

Nazwa Format Wystąpienia Opis
id Identyfikator Wymagane (1) Określa identyfikator opinii, który powinien zostać usunięty z pliku danych. Identyfikator musi być zgodny z atrybutem identyfikator elementu <review> w dowolnym pliku danych.

Zawiera

Nazwa Format Wystąpienia Opis
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Godzina, o której opinia została usunięta z systemu.

Przykład: 

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

Przykład

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