XML-Schemareferenz

Buch: /product-review-feeds/_book.yaml

Title: XML-Schemareferenz

Das XML-Schema für Google-Rezensionsfeeds definiert die zulässige Struktur Ihres XML-Feeds. XML-Schemas verwenden die Dateiendung .xsd. Wie DTD-Dateien definiert ein XML-Schema die Elemente und Attribute, die in einem XML-Dokument angezeigt werden können.

Weitere Informationen zu XML-Schemas finden Sie in dieser XML-Schema-Primer.

Das XML-Schema für Produktbewertungsfeeds wird hier veröffentlicht: http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd

Es folgt eine Beschreibung der durch dieses Schema definierten Feedstruktur. In dieser Beschreibung beziehen sich Typnamen mit dem Präfix xs: auf integrierte XML-Schematypen, die sich im XML-Namespace http://www.w3.org/2001/XMLSchema befinden.

Unser System erwartet immer einen vollständigen Feed. Alle bisher eingereichten Rezensionen, die nicht in deinem nächsten vollständigen Feed enthalten sind, werden gelöscht. Daher solltest du immer alle Rezensionen einreichen, wenn du deinen Feed einreichst.

Element der obersten Ebene: <feed>

Das Element <feed> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<version> Erforderlich (1) xs:string Gibt an, welche Version des Rezensionsfeedschemas verwendet wird. Derzeit wird nur <version>2.3</version> unterstützt.
<aggregator> Optional (1) aggregatorType Ein Publisher kann einen Rezensionsaggregator verwenden, um Rezensionen zu verwalten und die Feeds bereitzustellen. Dieses Element gibt die Verwendung eines Aggregators an und enthält Informationen zum Aggregator.
<publisher> Erforderlich (1) publisherType Die Informationen über den Publisher. Dies kann ein Einzelhändler, ein Hersteller, ein Rezensionsdienstleister oder eine andere Rechtspersönlichkeit sein, die Produktrezensionen veröffentlicht.
<reviews> Optional (1) xs:sequence Enthält die Rezensionen.

Mit <feed> werden Eindeutigkeitseinschränkungen für Elemente im Feed definiert.

Untergeordnete Elemente

<aggregator>

Ein Verlag oder Webpublisher kann einen Aggregator für Rezensionen verwenden, um Rezensionen zu verwalten und die Feeds bereitzustellen. Dieses Element gibt die Verwendung eines Aggregators an und enthält Informationen zum Aggregator. Das Element <aggregator> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<name> Erforderlich (1) nonEmptyStringType Der Name des Aggregators der Rezensionen.

<publisher>

Die Informationen zum Publisher. Dies kann ein Einzelhändler, ein Hersteller, ein Rezensionsunternehmen oder eine Rechtspersönlichkeit sein, die Produktrezensionen veröffentlicht. Das Element <publisher> enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<name> Erforderlich (1) nonEmptyStringType Der Name des Publishers der Rezensionen.
<favicon> Optional (1) httpUrlType Ein Link zum Favicon des Publishers des Unternehmens. Die Bildgröße muss eine Favicon-Größe von 16 x 16 Pixel haben. Das Bildformat muss GIF, JPG oder PNG sein.

<reviews>

Enthält die Rezensionen. Das Element <reviews> enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<review> Erforderlich (1 unbegrenzt) reviewType Eine individuelle Rezension für ein Produkt. Wenn sich eine Rezension auf mehrere Produkte im Inventar des Publishers bezieht, gib die Rezension einmal an und füge mehrere <product>-Elemente in das <products>-Element ein.

<review>

Eine individuelle Rezension für ein Produkt. Wenn sich eine Rezension auf mehrere Produkte im Publisher-Inventar bezieht, gib die Rezension einmal an und füge mehrere <product>-Elemente in das <products>-Element ein.Das <review>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<review_id> Optional (1) nonEmptyStringType Die permanente, eindeutige Kennung für die Produktüberprüfung im System des Verlags oder Webpublishers.
<reviewer> Erforderlich (1) reviewerType Der Autor der Rezension.
<review_timestamp> Erforderlich (1) xs:dateTime

Der Zeitstempel, der angibt, wann die Rezension geschrieben wurde.

Beispiele:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Optional (1) nonEmptyStringType Der Titel der Rezension.
<content> Erforderlich (1) nonEmptyStringType Der Inhalt der Rezension.
<pros> Optional (1) xs:sequence Enthält die Experten basierend auf der Meinung des Rezensenten. Textbausteine wie "pro:" weglassen, sofern sie nicht vom Prüfer geschrieben wurden
<cons> Optional (1) xs:sequence Enthält die Nachteile, die auf der Meinung des Rezensenten basieren. Textbausteine wie "con:" weglassen, sofern sie nicht vom Prüfer geschrieben wurden
<reviewer_images> Optional (1) xs:sequence Enthält Links zu Bildern des Produkts, die vom Rezensenten bereitgestellt wurden.
<review_url> Erforderlich (1) reviewUrlType Die URL der Landingpage der Rezension.
<ratings> Erforderlich (1) xs:sequence Enthält die mit der Rezension verknüpften Bewertungen.
<products> Erforderlich (1) xs:sequence Enthält die mit der Rezension verknüpften Produkte.
<is_spam> Optional (1) xs:boolean Gibt an, ob die Rezension im System des Verlags oder Webpublishers als Spam markiert wurde.
<collection_method> Optional (1) collectionMethodType

Die Methode, mit der die Rezension erfasst wurde. Folgende Werte sind zulässig:

unsolicited
Der Nutzer hat bei der Überprüfung der Rezension nicht auf eine bestimmte Anfrage reagiert.
post_fulfillment
Der Nutzer hat die Rezension nach einer Auftragserfüllung gesendet.
<transaction_id> Optional (1) nonEmptyStringType Eine permanente, eindeutige Kennung für die Transaktion, die im Zusammenhang mit der Rezension im System des Verlags oder Webpublishers steht. Diese ID kann verwendet werden, um anzugeben, dass mehrere Rezensionen mit derselben Transaktion verknüpft sind.

<reviewer>

Der Autor der Rezension. Das Element <reviewer> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<name> Erforderlich (1) reviewerNameType

Der Name des Autors der Rezension.

Beispiel:

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

Eine permanente, eindeutige Kennung für den Autor der Rezension im System des Verlags oder Webpublishers.

Beispiel:

<reviewer_id>14295</reviewer_id>

<name>

Der Name des Autors der Rezension. Das <name>-Element ist eine Erweiterung von nonEmptyStringType und enthält den Namen oder Alias des Rezensenten. Das Element <name> enthält diese Attribute.

Attribut Vorkommen Typ Beschreibung
is_anonymous Optional xs:boolean

Gibt an, ob der Rezensent anonym ist.

Beispiel:

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

<pros>

Enthält die Experten basierend auf der Meinung des Rezensenten. Das Element <pros> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<pro> Erforderlich (1 unbegrenzt) nonEmptyStringType

Ein Profi, der auf der Meinung des Rezensenten basiert. Die Dienstleister sollten in derselben Reihenfolge aufgeführt werden, in der sie angezeigt werden. Textbausteine wie „&prot;pro:" weglassen, es sei denn, sie wurden vom Rezensenten verfasst.

Beispiel:

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

<cons>

Enthält die Nachteile, die auf der Meinung des Rezensenten basieren. Das Element <cons> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<con> Erforderlich (1 unbegrenzt) nonEmptyStringType

Ein einzelner Nutzer, der auf der Meinung des Rezensenten basiert. Die Nachteile sollten in der Reihenfolge ihrer Anzeige aufgeführt werden. Textbausteine wie "con:" weglassen, sofern sie nicht vom Prüfer geschrieben wurden

Beispiel:

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

<review_url>

Die URL der Landingpage der Rezension. Das <review_url>-Element ist eine Erweiterung von httpUrlType und enthält einen Link zur Landingpage der Rezension. Das Element <review_url> enthält diese Attribute.

Attribut Vorkommen Typ Beschreibung
type Required xs:string

Es muss einer der folgenden Typen sein:

singleton
Die Rezensionsseite enthält nur diese eine Rezension.
group
Die Rezensionsseite enthält eine Gruppe von Rezensionen, zu denen diese Rezension gehört.

Beispiel:

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

<reviewer_images>

Enthält Bilder des vom Rezensenten bereitgestellten Produkts. Das Tag <reviewer_images> enthält viele <reviewer_image>-Elemente.

Element Vorkommen Typ Beschreibung
<reviewer_image> Erforderlich (1 unbegrenzt) reviewImageType

Ein Bild des Rezensionsprodukts, das vom Autor der Rezension erstellt wurde.

<reviewer_image>

Ein Bild aus einem einzelnen Rezensionsbild.

Element Vorkommen Typ Beschreibung
<url> Erforderlich (1) httpUrlType

Eine URL zu einem Bild des Rezensionsprodukts, das vom Autor der Rezension erstellt wurde. Die URL muss nicht mit einer Bilddateierweiterung enden.

Beispiel:

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

Enthält die mit der Rezension verknüpften Bewertungen. Das Element <ratings> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<overall> Erforderlich (1) ratingType Die Gesamtbewertung des Rezensenten.

<overall>

Die Gesamtbewertung des Rezensenten. Das Element <overall> erweitert ein xs:decimal simpleType-Element und erfasst die vom Prüfer zugewiesene Bewertung. Der Wert sollte sich innerhalb des Bereichs befinden, der durch die Attribute min und max definiert wird. Das Element <overall> enthält diese Attribute.

Attribut Vorkommen Typ Beschreibung
min Required xs:integer Die mögliche Mindestzahl für die Bewertung. Dies sollte die schlechteste mögliche Bewertung sein und sollte kein Wert ohne Bewertung sein.
max Required xs:integer Die maximal mögliche Zahl für die Bewertung. Der Wert des Attributs max muss größer als der Wert des Attributs min sein.

<products>

Enthält die mit der Rezension verknüpften Produkte. Das Element <products> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<product> Erforderlich (1 unbegrenzt) productType Ein mit der Rezension verknüpftes Produkt.

<product>

Ein mit der Rezension verknüpftes Produkt. Das Element <product> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<product_ids> Optional (1) productIdsType Die mit einem Produkt verknüpften IDs.
<product_name> Optional (1) nonEmptyStringType Beschreibender Name eines Produkts.
<product_url> Erforderlich (1) httpUrlType Die URL des Produkts. Diese URL kann denselben Wert wie das Element <review_url> haben, wenn sie und die Produkt-URL identisch sind.

<product_ids>

Die mit einem Produkt verknüpften IDs. Das Element <product_ids> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<gtins> Erforderlich (für alle Rezensionen, die mit Produkten mit einer bekannten GTIN verknüpft sind, um eine vollständige Rezension zu ermöglichen)

Optional (dringend empfohlen) für alle anderen Rezensionen (1)		 gtinsType Enthält GTINs (Global Trade Item Numbers), die einem Produkt zugeordnet sind.
<mpns> Erforderlich (MPN, um den Abgleich von Rezensionen zu vereinfachen, wenn das mit der Rezension verknüpfte Produkt keine GTIN hat). Muss mit Marke eingereicht werden)

Optional für alle anderen Rezensionen (1)		 mpnsType Enthält MPNs (Teilenummer des Herstellers), die mit einem Produkt verknüpft sind.
<skus> Erforderlich (Artikelnummer sollte zur Ermöglichung des Abgleichs von Rezensionen enthalten sein, wenn dem Produkt, das mit der Rezension verknüpft ist) keine GTIN oder MPN zugewiesen ist. Sollte zusammen mit dem Produkt eingereicht werden)

Optional für alle anderen Rezensionen (1)		 skusType Enthält Artikelnummern (Stock Keeping Unit, Artikelnummern), die mit einem Produkt verknüpft sind. Häufig stimmt das mit der Angebots-ID im Produktfeed überein.
<brands> Erforderlich (Marke sollte hinzugefügt werden, um den Abgleich von Rezensionen zu ermöglichen, wenn dem Produkt, das mit der Rezension verknüpft ist) keine GTIN zugewiesen ist. Muss mit MPN eingereicht werden

Optional für alle anderen Rezensionen (1)		 brandsType Enthält Markennamen, die mit einem Produkt verknüpft sind.
<asins> Optional (1) asinsType Enthält ASINs (Amazon Standard Identification Numbers), die mit einem Produkt verknüpft sind.

<gtins>

Enthält GTINs (Global Trade Item Numbers), die einem Produkt zugeordnet sind. Das Element <gtins> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<gtin> Erforderlich (1 unbegrenzt) nonEmptyStringType Die Global Trade Item Number des Produkts.

<mpns>

Enthält MPNs (Teilenummer des Herstellers), die mit einem Produkt verknüpft sind. Das Element <mpns> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<mpn> Erforderlich (1 unbegrenzt) nonEmptyStringType Die Teilenummer des Herstellers.

<skus>

Enthält Artikelnummern (Stock Keeping Unit, Artikelnummern), die mit einem Produkt verknüpft sind. Das Element <skus> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<sku> Erforderlich (1 unbegrenzt) nonEmptyStringType Die vorrätige Einheit des Produkts im Inventar des Publishers.

<brands>

Enthält Markennamen, die mit einem Produkt verknüpft sind. Das Element <brands> enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<brand> Erforderlich (1 unbegrenzt) nonEmptyStringType Der Markenname des Produkts.

<asins>

Enthält ASINs (Amazon Standard Identification Numbers), die mit einem Produkt verknüpft sind. Das Element enthält diese Elemente in der angegebenen Reihenfolge.

Element Vorkommen Typ Beschreibung
<asin> Erforderlich (1 unbegrenzt) nonEmptyStringType Amazon Standard-Identifikationsnummer des Produkts. Jede ASIN ist 10 Zeichen lang und alphanumerisch.