XML-Schemareferenz

Das XML-Schema für Rezensionsfeeds im Google Merchant Center definiert die zulässige Struktur Ihres XML-Feeds. XML-Schemas haben die Dateiendung .xsd. Wie DTD-Dateien definiert ein XML-Schema die Elemente und Attribute, die in einem XML-Dokument enthalten sein können.

Weitere Informationen zu XML-Schemas

Das XML-Schema für Rezensionsfeeds ist hier verfügbar: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Im Folgenden wird die durch dieses Schema definierte Feedstruktur beschrieben. 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 zuvor eingereichten Rezensionen, die nicht in Ihrem nächsten vollständigen Feed enthalten sind, werden gelöscht. Daher sollten Sie immer alle Rezensionen einreichen, wenn Sie Ihren Feed einreichen.

<feed>-Element der obersten Ebene

Das <feed>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<version> Erforderlich (1) xs:string Gibt an, welche Version des Feedschemas für Produktrezensionen verwendet wird. Derzeit wird nur <version>2.4</version> unterstützt.
<aggregator> Optional (1) aggregatorType Ein Publisher kann einen Dienstleister 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.
<publisher> Erforderlich (1) publisherType Informationen zum Publisher, der ein Einzelhändler, Hersteller, Rezensionsdienst oder eine andere Organisation sein kann, die Produktrezensionen veröffentlicht.
<reviews> Optional (1) xs:sequence Enthält die Produktrezensionen.

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

Untergeordnete Elemente

<aggregator>

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

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

<publisher>

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

Element Vorkommen Typ Beschreibung
<name> Erforderlich (1) nonEmptyStringType Der Name des Publishers der Produktrezensionen.
<favicon> Optional (1) httpUrlType Ein Link zum Unternehmens-Favicon des Publishers. Die Bildabmessungen sollten der Favicon-Größe entsprechen: 16 × 16 Pixel. Das Bildformat sollte GIF, JPG oder PNG sein.

<reviews>

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

Element Vorkommen Typ Beschreibung
<review> Erforderlich (1–unbegrenzt) reviewType Eine einzelne eindeutige Produktrezension. Wenn sich eine Rezension auf mehrere Produkte im Inventar des Verlags bezieht, geben Sie die Rezension einmal an und fügen Sie dem <products>-Element mehrere <product>-Elemente hinzu.

<review>

Eine einzelne eindeutige Produktrezension. Wenn sich eine Rezension auf mehrere Produkte im Inventar des Verlags oder Webpublishers bezieht, geben Sie die Rezension einmal an und fügen Sie dem <products>-Element mehrere <product>-Elemente hinzu.Das <review>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<review_id> Erforderlich (1) nonEmptyStringType Die dauerhafte, eindeutige Kennung für die Rezension im System des Publishers.
<reviewer> Erforderlich (1) reviewerType Der Autor der Produktrezension.
<is_verified_purchase> Optional (1) xs:boolean Gibt an, ob überprüft wurde, ob der Rezensent das Produkt gekauft hat.
<is_incentivized_review> Optional (1) xs:boolean Gibt an, ob der Rezensent für die Rezension des Produkts einen Anreiz erhalten hat.
<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.
<review_language> Optional (1) xs:string Die Sprache der Rezension (BCP 47).
<review_country> Optional (1) xs:string Der Ländercode (ISO 3166-1) des Rezensenten.
<pros> Optional (1) xs:sequence Enthält die Vorteile aus der Sicht des Rezensenten. Lassen Sie Textbausteine wie „Vorteil:“ weg, es sei denn, sie wurden vom Rezensenten geschrieben.
<cons> Optional (1) xs:sequence Enthält die Nachteile, die der Rezensent sieht. Lassen Sie Standardtext wie „Nachteil:“ weg, es sei denn, er wurde vom Rezensenten geschrieben.
<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 Rezensions-Landingpage.
<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 Publishers als Spam gekennzeichnet ist.
<collection_method> Optional (1) collectionMethodType

Die Methode, mit der die Rezension erfasst wurde. Der Wert muss einer der folgenden sein:

unsolicited
Der Nutzer hat die Rezension ohne eine bestimmte Aufforderung gepostet.
post_fulfillment
Der Nutzer hat die Rezension aufgrund einer Aufforderung gepostet, nachdem seine Bestellung ausgeführt wurde.
<transaction_id> Optional (1) nonEmptyStringType Eine dauerhafte, eindeutige Kennzeichnung für die Transaktion, die mit der Rezension im System des Publishers verknüpft ist. Mit dieser ID kann angegeben werden, dass mehrere Rezensionen mit derselben Transaktion verknüpft sind.

<reviewer>

Der Autor der Produktrezension. Das <reviewer>-Element enthält diese Elemente in der aufgeführten 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 dauerhafte, eindeutige Kennzeichnung für den Autor der Rezension im System des Publishers.

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 <name>-Element enthält die folgenden 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 Vorteile aus der Sicht des Rezensenten. Das <pros>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

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

Ein individueller Vorteil, der auf der Meinung des Rezensenten basiert. Die Vorteile sollten in derselben Reihenfolge aufgeführt werden, in der sie angezeigt werden. Lassen Sie Textbausteine wie „Vorteil:“ weg, es sei denn, sie wurden vom Rezensenten geschrieben.

Beispiel:

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

<cons>

Enthält die Nachteile, die der Rezensent sieht. Das <cons>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

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

Ein individueller Nachteil, der auf der Meinung des Rezensenten basiert. Die Nachteile sollten in derselben Reihenfolge aufgeführt werden, in der sie angezeigt werden. Lassen Sie Textbausteine wie „Nachteil:“ weg, es sei denn, sie wurden vom Rezensenten geschrieben.

Beispiel:

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

<review_url>

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

Attribut Vorkommen Typ Beschreibung
type Erforderlich xs:string

Der Typ muss einer der folgenden sein:

singleton
Die Rezensionsseite enthält nur diese eine Rezension.
group
Die Rezensionsseite enthält eine Gruppe von Rezensionen, darunter auch diese.

Beispiel:

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

<reviewer_images>

Enthält Bilder des Produkts, die vom Rezensenten bereitgestellt wurden. Das <reviewer_images>-Tag enthält viele <reviewer_image>-Elemente.

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

Ein Bild des rezensierten Produkts, das vom Rezensionsautor erstellt wurde.

<reviewer_image>

Ein einzelnes Rezensionsbildelement.

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

Eine URL zu einem Bild des rezensierten Produkts, das vom Rezensenten erstellt wurde. Die URL muss nicht mit einer Bilddateiendung 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 <ratings>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

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

<overall>

Die Gesamtbewertung des Produkts durch den Rezensenten. Das <overall>-Element erweitert ein xs:decimal simpleType-Element und erfasst die vom Rezensenten zugewiesene Bewertung. Der Wert muss innerhalb des inklusiven Bereichs liegen, der durch die Attribute min und max definiert wird. Das <overall>-Element enthält die folgenden Attribute.

Attribut Vorkommen Typ Beschreibung
min Erforderlich xs:integer Die niedrigst mögliche Zahl für die Bewertung. Dies sollte die schlechtestmögliche Bewertung sein und nicht ein Wert für keine Bewertung.
max Erforderlich xs:integer Die maximal mögliche Anzahl für die Bewertung. Der Wert des Attributs max muss größer sein als der Wert des Attributs min.

<products>

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

Element Vorkommen Typ Beschreibung
<product> Erforderlich (1–unbegrenzt) productType Ein Produkt, das mit der Rezension verknüpft ist.

<product>

Ein Produkt, das mit der Rezension verknüpft ist. Das <product>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<product_ids> Optional (1) productIdsType Die mit einem Produkt verknüpften Kennzeichnungen.
<product_name> Optional (1) nonEmptyStringType Aussagekräftiger Name eines Produkts.
<product_url> Erforderlich (1) httpUrlType Die URL des Produkts. Diese URL kann denselben Wert wie das Element <review_url> haben, wenn die URL von Rezensionen und Produkten identisch ist.

<product_ids>

Die mit einem Produkt verknüpften Kennzeichnungen. Das Element <product_ids> enthält die folgenden 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)

Optional für alle anderen Rezensionen (1)		 gtinsType Enthält GTINs (Global Trade Item Numbers), die mit einem Produkt verknüpft sind. Untertypen von GTINs (z.B. UPC, EAN, ISBN, JAN) werden unterstützt.
<mpns> Erforderlich (für alle Rezensionen, die mit Produkten mit einer bekannten MPN verknüpft sind)

Optional für alle anderen Rezensionen (1)		 mpnsType Enthält die Teilenummern des Herstellers (Manufacturer Part Numbers, MPNs), die mit einem Produkt verknüpft sind.
<skus> Erforderlich (für alle Rezensionen, die mit Produkten mit einer bekannten Artikelnummer verknüpft sind)

Optional für alle anderen Rezensionen (1)		 skusType Enthält Artikelnummern, die mit einem Produkt verknüpft sind. Häufig entspricht sie der Angebots-ID des Produkts im Produktfeed.
<brands> Erforderlich für alle Rezensionen, die mit Produkten mit einer bekannten Marke verknüpft sind

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 einem Produkt zugeordnet sind.

<gtins>

Enthält GTINs (Global Trade Item Numbers), die mit einem Produkt verknüpft sind. Das <gtins>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<gtin> Erforderlich (1–unbegrenzt) nonEmptyStringType Die Global Trade Item Number des Produkts. Untertypen von GTINs (z.B. UPC, EAN, ISBN, JAN) werden unterstützt.

<mpns>

Enthält die Teilenummern des Herstellers (Manufacturer Part Numbers, MPNs), die mit einem Produkt verknüpft sind. Das <mpns>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<mpn> Erforderlich (1–unbegrenzt) nonEmptyStringType Die Teilenummer des Herstellers für das Produkt.

<skus>

Enthält Artikelnummern, die mit einem Produkt verknüpft sind. Das <skus>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

Element Vorkommen Typ Beschreibung
<sku> Erforderlich (1–unbegrenzt) nonEmptyStringType Die Artikelnummer des Produkts im Inventar des Verlags.

<brands>

Enthält Markennamen, die mit einem Produkt verknüpft sind. Das Element <brands> enthält die folgenden 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 <asins>-Element enthält diese Elemente in der aufgeführten Reihenfolge.

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