Schemat XML

W tej sekcji opisujemy schemat XML używany w pliku danych z opiniami o sprzedawcach.

Element najwyższego poziomu: <feed>

Opis

Najwyższy element kontenera, który zawiera wszystkie pozostałe elementy pliku danych.

Atrybuty

Nazwa Format Wystąpienia Opis
xmlns xs:string Wymagane (1) Wpisz na stałe tę wartość:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Wymagane (1) Wpisz na stałe tę wartość:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Wymagane (1) Wpisz na stałe tę wartość, pozostawiając między adresami URL jedną spację:
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       -- Opcjonalne (0–1) Element kontenera dla elementów <merchant>.
deleted_merchants       -- Opcjonalne (0–1) Element kontenera dla elementów <deleted_merchant>.
reviews       -- Opcjonalne (0–1) Element kontenera dla elementów <review>.
deleted_reviews       -- Opcjonalne (0–1) Element kontenera dla elementów <deleted_review>.

<merchants>

Opis

Kontener elementów <merchant>.

Zawiera

Nazwa Format Wystąpienia Opis
merchant       -- Wymagany (1–n) Element powtarzany dla każdego sprzedawcy.

<merchant>

Opis

Każdy element <merchant> zawiera informacje i opinie o jednym 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 przesłany dziś i plik danych przesłany 90 dni temu odnoszą się do tego samego sprzedawcy, muszą mieć ten sam identyfikator.

Przykład

<merchant id="2739">

Zawiera

W elemencie sprzedawcy uwzględnij te elementy:

Nazwa Format Wystąpienia Opis
name NonEmptyString Wymagane (1) Czytelna nazwa sprzedawcy.
merchant_url xs:anyURI Wymagane (1) Adres URL głównej witryny sprzedawcy.
Nie używaj adresu URL przekierowania dla tej wartości. Innymi słowy, wartość powinna prowadzić bezpośrednio do witryny sprzedawcy.

Przykład: 

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

rating_url xs:anyURI Wymagane (1) Adres URL strony docelowej, na której znajdują się opinie o tym sprzedawcy.
Nie używaj przekierowania.

Przykład: 

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

create_timestamp DateTimeWithTimeZone Wymagane (1) Data i godzina utworzenia sprzedawcy. Te zasady są niezmienne.
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Data i godzina ostatniej aktualizacji informacji o sprzedawcy. Jeśli którekolwiek z pól w elemencie <merchant> zostanie zaktualizowane dla danego identyfikatora sprzedawcy, ta wartość również musi ulec zmianie.

<deleted_merchants>

Opis

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

Zawiera

Nazwa Format Wystąpienia Opis
deleted_merchant       -- Wymagany (1–n) Zawiera elementy związane z jednym 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óry ma zostać usunięty z pliku danych. Identyfikator musi być zgodny z atrybutem id elementu <merchant> w dowolnym poprzednim pliku danych.

Zawiera

Nazwa Format Wystąpienia Opis
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Data i 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       -- Wymagany (1–n) Element powtarzany w przypadku każdej opinii.

<review>

Opis

Kontener na szczegóły związane z opinią.

Atrybuty

Nazwa Format Wystąpienia Opis
id Identyfikator Wymagane (1) Identyfikator opinii w Twoim 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 ta opinia.

Zawiera

W elemencie opinii uwzględnij te elementy:

Nazwa Format Wystąpienia Opis
reviewer_name NonEmptyString Opcjonalne (0–1) Wyświetlana nazwa autora opinii, pod warunkiem że opinia powinna mieć 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. Te zasady są niezmienne.

Przykład: 

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

last_update_timestamp DateTimeWithTimeZone Wymagane (1) Data i godzina ostatniej zmiany informacji w elemencie <review>. Jeśli którekolwiek z pól w elemencie <review> zostanie zaktualizowane w przypadku danego identyfikatora opinii, ta wartość również musi ulec zmianie.

Przykład: 

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

country_code CountryCode Wymagane (1) Kraj autora opinii. W miarę możliwości jest to kraj, do którego produkt został wysłany lub w którym świadczona jest usługa. W przeciwnym razie podaj nazwę kraju, w którym znajduje się użytkownik w momencie dodawania opinii. Kod kraju musi być w formacie ISO 3166-1 alfa-2.

Przykład: 

  <country_code>
    US
  </country_code>

title xs:string Opcjonalne (0–1) Tytuł opinii. Tytuł powinien być zwykłym tekstem bez tagów HTML.

Przykład: 

  <title>
    Great prices
  </title>

content xs:string Wymagane (1) Treść opinii. Powinien to być dowolny tekst podany przez użytkownika, który nie powinien być skracany. Treść powinna być zwykłym tekstem bez tagów HTML. Na przykład podział wiersza powinien być reprezentowany przez znak przejścia do nowej linii, a nie tag <br>. Jeśli podasz kilka odpowiedzi na różne pytania, uwzględnij wszystkie odpowiedzi, dodając minimalny kontekst, aby miały sens. Jeśli pytania pozostały bez odpowiedzi, nie należy podawać kontekstu.

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 na potrzeby ocen sprzedawcy przez recenzenta. Jeśli dla elementu <overall> nie ma oceny, całą powiązaną opinię należy wykluczyć z pliku danych, ponieważ element <overall> jest wymagany, a opinia bez niego nie zostanie zaakceptowana.
collection_method CollectionMethodType Wymagane (1) Metoda, która została użyta do zebrania opinii. Musi to być jedna z tych wartości:
  • bez prośby: użytkownik przesłał opinię bez żadnej konkretnej zachęty.
  • point_of_sale: użytkownik przesłał opinię w odpowiedzi na prośbę po złożeniu zamówienia.
  • after_fulfillment: użytkownik przesłał opinię w odpowiedzi na prośbę po realizacji zamówienia.

Przykład: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Opis

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

Zawiera

W elemencie oceny uwzględnij te elementy:

Nazwa Format Wystąpienia Opis
overall RatingRange Wymagane (1) Ogólna ocena sprzedawcy wystawiona przez recenzenta.

Przykład: 

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

customer_service RatingRange Opcjonalne (0–1) Ocena jakości obsługi klienta u tego sprzedawcy wystawiona przez osobę oceniającą.

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       -- Wymagany (1–n) Zawiera elementy związane z jedną usuniętą opinią.

<deleted_review>

Opis

sprawdzić, która opinia została usunięta;

Atrybuty

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

Zawiera

Nazwa Format Wystąpienia Opis
last_update_timestamp DateTimeWithTimeZone Wymagane (1) Czas usunięcia opinii 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>