Dokumentacja schematu XML

Schemat XML plików danych z opiniami o produktach w Google określa dopuszczalną strukturę pliku danych XML. Schematy XML mają rozszerzenie .xsd. Podobnie jak pliki DTD, schemat XML określa elementy i atrybuty, które mogą występować w dokumencie XML.

Więcej informacji o schematach XML znajdziesz w tym wprowadzeniu do schematów XML.

Schemat XML plików danych z opiniami o produktach znajdziesz tutaj:http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Poniżej znajduje się opis struktury pliku danych zdefiniowanej przez ten schemat. W tym opisie nazwy typów z prefiksem xs: odnoszą się do wbudowanych typów schematu XML, które znajdują się w przestrzeni nazw XML http://www.w3.org/2001/XMLSchema.

Nasz system zawsze oczekuje pełnego pliku danych. Wszystkie wcześniej przesłane opinie, które nie zostaną uwzględnione w następnym pełnym pliku danych, zostaną usunięte. Dlatego podczas przesyłania pliku danych zawsze przesyłaj wszystkie opinie.

Element <feed> najwyższego poziomu

Element <feed> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<version> Wymagany (1) xs:string Wskazuje, która wersja schematu pliku danych opinii o produktach jest używana. Obecnie obsługiwana jest tylko wartość <version>2.4</version>.
<aggregator> Opcjonalnie (1) aggregatorType Wydawca może korzystać z usług pośrednika gromadzącego opinie o produktach, aby zarządzać opiniami i dostarczać pliki danych. Ten element wskazuje na użycie agregatora i zawiera informacje o nim.
<publisher> Wymagany (1) publisherType Informacje o wydawcy, którym może być sprzedawca, producent, firma zajmująca się opiniami lub dowolny podmiot publikujący opinie o produktach.
<reviews> Opcjonalnie (1) xs:sequence Zawiera recenzje produktów.

<feed> określa ograniczenia dotyczące unikalności elementów używanych w pliku danych.

Elementy podrzędne

<aggregator>

Wydawca może korzystać z usług pośrednika gromadzącego opinie o produktach, aby zarządzać opiniami i dostarczać pliki danych. Ten element wskazuje, że używany jest agregator, i zawiera informacje o nim. Element <aggregator> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<name> Wymagane (1) nonEmptyStringType Nazwa agregatora opinii o produktach.

<publisher>

Informacje o wydawcy, którym może być sprzedawca, producent, firma zajmująca się opiniami lub dowolny podmiot publikujący opinie o produktach.Element <publisher> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<name> Wymagane (1) nonEmptyStringType Nazwa wydawcy opinii o produktach.
<favicon> Opcjonalnie (1) httpUrlType Link do ikony firmy wydawcy. Wymiary obrazu powinny być takie jak w przypadku ikony: 16 x 16 pikseli. Obraz powinien mieć format GIF, JPG lub PNG.

<reviews>

Zawiera opinie o produkcie. Element <reviews> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<review> Wymagane (1–nieograniczona liczba) reviewType Pojedyncza, unikalna opinia o produkcie. Jeśli opinia dotyczy wielu produktów w asortymencie wydawcy, podaj ją raz i uwzględnij kilka elementów <product> w elemencie <products>.

<review>

Pojedyncza, unikalna opinia o produkcie. Jeśli opinia dotyczy wielu produktów w asortymencie wydawcy, podaj ją raz i uwzględnij kilka elementów <product> w elemencie <products>.Element <review> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<review_id> Wymagane (1) nonEmptyStringType Trwały, unikalny identyfikator opinii o produkcie w systemie wydawcy.
<reviewer> Wymagane (1) reviewerType Autor opinii o produkcie.
<is_verified_purchase> Opcjonalnie (1) xs:boolean Wskazuje, czy zweryfikowano, że recenzent kupił produkt.
<is_incentivized_review> Opcjonalnie (1) xs:boolean Wskazuje, czy recenzent otrzymał zachętę do napisania opinii o produkcie.
<review_timestamp> Wymagane (1) xs:dateTime

Sygnatura czasowa wskazująca, kiedy została napisana opinia.

Przykłady:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Opcjonalnie (1) nonEmptyStringType Tytuł opinii.
<content> Wymagane (1) nonEmptyStringType Treść opinii.
<review_language> Opcjonalnie (1) xs:string Język opinii (BCP 47).
<review_country> Opcjonalnie (1) xs:string Kod kraju (ISO 3166-1) recenzenta.
<pros> Opcjonalnie (1) xs:sequence Zawiera zalety na podstawie opinii recenzenta. Pomiń tekst standardowy, np. „zalety:”, chyba że został napisany przez recenzenta.
<cons> Opcjonalnie (1) xs:sequence Zawiera wady na podstawie opinii recenzenta. Pomiń standardowy tekst, np. „wady:”, chyba że został napisany przez recenzenta.
<reviewer_images> Opcjonalnie (1) xs:sequence Zawiera linki do zdjęć produktu dostarczonych przez osobę, która napisała opinię.
<review_url> Wymagane (1) reviewUrlType Adres URL strony docelowej opinii.
<ratings> Wymagane (1) xs:sequence Zawiera oceny powiązane z opinią.
<products> Wymagane (1) xs:sequence Zawiera produkty powiązane z opinią.
<is_spam> Opcjonalnie (1) xs:boolean Wskazuje, czy opinia jest oznaczona jako spam w systemie wydawcy.
<collection_method> Opcjonalnie (1) collectionMethodType

Metoda, za pomocą której zebrano opinię. Musi mieć jedną z tych wartości:

unsolicited
Użytkownik przesłał opinię bez żadnej konkretnej zachęty.
post_fulfillment
Użytkownik przesłał opinię w odpowiedzi na prośbę po zrealizowaniu zamówienia.
<transaction_id> Opcjonalnie (1) nonEmptyStringType Trwały, unikalny identyfikator transakcji powiązanej z opinią w systemie wydawcy. Ten identyfikator może służyć do wskazywania, że z tą samą transakcją jest powiązanych wiele opinii.

<reviewer>

Autor opinii o produkcie. Element <reviewer> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<name> Wymagane (1) reviewerNameType

Imię i nazwisko autora opinii.

Przykład:

<name>Jane</name>
<reviewer_id> Opcjonalnie (1) nonEmptyStringType

Trwały, unikalny identyfikator autora opinii w systemie wydawcy.

Przykład:

<reviewer_id>14295</reviewer_id>

<name>

Imię i nazwisko autora opinii. Element <name> jest rozszerzeniem elementu nonEmptyStringType i zawiera imię lub alias autora opinii. Element <name> zawiera te atrybuty.

Atrybut Wystąpienie Typ Opis
is_anonymous Opcjonalny xs:boolean

Wskazuje, czy osoba dodająca opinię jest anonimowa.

Przykład:

<name is_anonymous="true">Anonymous</name>

<pros>

Zawiera zalety na podstawie opinii recenzenta. Element <pros> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<pro> Wymagane (1–nieograniczona liczba) nonEmptyStringType

Indywidualna zaleta na podstawie opinii recenzenta. Zalety powinny być wymienione w tej samej kolejności, w jakiej są wyświetlane. Pomiń tekst standardowy, np. „zalety:”, chyba że został napisany przez autora opinii.

Przykład:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

Zawiera wady na podstawie opinii recenzenta. Element <cons> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<con> Wymagane (1–nieograniczona liczba) nonEmptyStringType

Wada określona na podstawie opinii recenzenta. Wady powinny być wymienione w tej samej kolejności, w jakiej są wyświetlane. Pomiń tekst standardowy, np. „wada:”, chyba że został napisany przez recenzenta.

Przykład:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

Adres URL strony docelowej opinii. Element <review_url> jest rozszerzeniem elementu httpUrlType i zawiera link do strony docelowej z opinią. Element <review_url> zawiera te atrybuty.

Atrybut Wystąpienie Typ Opis
type Wymagany xs:string

Typ musi mieć jedną z tych wartości:

singleton
Strona opinii zawiera tylko tę jedną opinię.
group
Strona opinii zawiera grupę opinii, w tym tę opinię.

Przykład:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Zawiera zdjęcia produktu dostarczone przez recenzenta. Tag <reviewer_images> zawiera wiele elementów <reviewer_image>.

Element Wystąpienie Typ Opis
<reviewer_image> Wymagane (1–nieograniczona liczba) reviewImageType

Zdjęcie ocenianego produktu utworzone przez autora opinii.

<reviewer_image>

Pojedynczy element graficzny opinii.

Element Wystąpienie Typ Opis
<url> Wymagane (1) httpUrlType

Adres URL zdjęcia recenzowanego produktu utworzonego przez autora opinii. Adres URL nie musi kończyć się rozszerzeniem pliku graficznego.

Przykład:

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

Zawiera oceny powiązane z opinią. Element <ratings> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<overall> Wymagane (1) ratingType Ogólna ocena produktu przez recenzenta.

<overall>

Ogólna ocena produktu przez recenzenta. Element <overall> rozszerza element xs:decimal simpleType i zawiera ocenę przyznaną przez autora opinii. Wartość powinna mieścić się w zakresie określonym przez atrybuty min i max. Element <overall> zawiera te atrybuty.

Atrybut Wystąpienie Typ Opis
min Wymagany xs:integer Minimalna możliwa liczba w ocenie. Powinna to być najgorsza możliwa ocena, a nie wartość oznaczająca brak oceny.
max Wymagany xs:integer Maksymalna możliwa liczba dla oceny. Wartość atrybutu max musi być większa niż wartość atrybutu min.

<products>

Zawiera produkty powiązane z opinią. Element <products> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<product> Wymagane (1–nieograniczona liczba) productType Produkt powiązany z opinią.

<product>

Produkt powiązany z opinią. Element <product> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<product_ids> Opcjonalnie (1) productIdsType Identyfikatory powiązane z produktem.
<product_name> Opcjonalnie (1) nonEmptyStringType Nazwa opisowa produktu.
<product_url> Wymagane (1) httpUrlType Adres URL produktu. Ten adres URL może mieć taką samą wartość jak element <review_url>, jeśli adres URL opinii i adres URL produktu są takie same.

<product_ids>

Identyfikatory powiązane z produktem. Element <product_ids> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<gtins> Wymagany (w przypadku wszystkich opinii powiązanych z produktami o znanym numerze GTIN)

Opcjonalny w przypadku wszystkich innych opinii (1)		 gtinsType Zawiera globalne numery jednostki handlowej (GTIN) powiązane z produktem. Obsługiwane są podtypy numerów GTIN (np. UPC, EAN, ISBN, JAN).
<mpns> Wymagany (w przypadku wszystkich opinii powiązanych z produktami o znanym numerze MPN)

Opcjonalny w przypadku wszystkich innych opinii (1)		 mpnsType Zawiera numery MPN (numery katalogowe producenta) powiązane z produktem.
<skus> Wymagany (w przypadku wszystkich opinii powiązanych z produktami o znanym kodzie SKU)

Opcjonalny w przypadku wszystkich innych opinii (1)		 skusType Zawiera kody SKU (jednostki magazynowe) powiązane z produktem. Często jest on zgodny z identyfikatorem oferty produktu w pliku danych o produktach.
<brands> Wymagany (w przypadku wszystkich opinii powiązanych z produktami ze znaną marką)

Opcjonalny w przypadku wszystkich innych opinii (1)		 brandsType Zawiera nazwy marek powiązanych z produktem.
<asins> Opcjonalnie (1) asinsType Zawiera numery ASIN (Amazon Standard Identification Numbers) powiązane z produktem.

<gtins>

Zawiera globalne numery jednostki handlowej (GTIN) powiązane z produktem. Element <gtins> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<gtin> Wymagane (1–nieograniczona liczba) nonEmptyStringType Globalny numer jednostki handlowej produktu. Obsługiwane są podtypy numerów GTIN (np. UPC, EAN, ISBN, JAN).

<mpns>

Zawiera numery MPN (numery katalogowe producenta) powiązane z produktem. Element <mpns> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<mpn> Wymagane (1–nieograniczona liczba) nonEmptyStringType Numer katalogowy produktu.

<skus>

Zawiera kody SKU (jednostki magazynowe) powiązane z produktem. Element <skus> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<sku> Wymagane (1–nieograniczona liczba) nonEmptyStringType Kod SKU produktu w asortymencie wydawcy.

<brands>

Zawiera nazwy marek powiązanych z produktem. Element <brands> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<brand> Wymagane (1–nieograniczona liczba) nonEmptyStringType Nazwa marki produktu.

<asins>

Zawiera numery ASIN (Amazon Standard Identification Numbers) powiązane z produktem. Element <asins> zawiera te elementy w podanej kolejności.

Element Wystąpienie Typ Opis
<asin> Wymagane (1–nieograniczona liczba) nonEmptyStringType Numer identyfikacyjny produktu w Amazonie. Każdy ASIN ma 10 znaków i jest alfanumeryczny.