XML-Schema

In diesem Abschnitt wird das XML-Schema für den Feed mit Händlerrezensionsdaten beschrieben.

Element der obersten Ebene: <feed>

Beschreibung

Das oberste Containerelement, das alle anderen Elemente im Feed enthält.

Attribute

Name Format Häufigkeit Beschreibung
xmlns xs:string Erforderlich (1) Bitte codieren Sie den folgenden Wert fest:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Erforderlich (1) Bitte codieren Sie den folgenden Wert fest:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Erforderlich (1) Bitte codieren Sie den folgenden Wert fest und lassen Sie ein einzelnes Leerzeichen zwischen den URLs:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Beispiel

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

Enthält

Name Format Häufigkeit Beschreibung
merchants       -- Optional (0–1) Containerelement für <merchant>-Elemente.
deleted_merchants       -- Optional (0–1) Containerelement für <deleted_merchant>-Elemente.
reviews       -- Optional (0–1) Containerelement für <review>-Elemente.
deleted_reviews       -- Optional (0–1) Containerelement für <deleted_review>-Elemente.

<merchants>

Beschreibung

Container für <merchant>-Elemente.

Enthält

Name Format Häufigkeit Beschreibung
merchant       -- Erforderlich (1–n) Das Element wird für jeden Händler wiederholt.

<merchant>

Beschreibung

Jedes <merchant>-Element enthält Informationen und Rezensionen für einen Händler.

Attribute

Name Format Häufigkeit Beschreibung
id Id Erforderlich (1) Muss für alle Feeds eindeutig und stabil sein. Wenn sich ein Feed von heute und ein Feed von vor 90 Tagen auf denselben Händler beziehen, müssen sie dieselbe ID haben.

Beispiel

<merchant id="2739">

Enthält

Fügen Sie dem Händlerelement die folgenden Elemente hinzu.

Name Format Häufigkeit Beschreibung
name NonEmptyString Erforderlich (1) Für Menschen lesbarer Anzeigename des Händlers.
merchant_url xs:anyURI Erforderlich (1) URL der Hauptwebsite des Händlers.
Verwenden Sie für diesen Wert keine Weiterleitungs-URL. Der Wert sollte also direkt auf die Website des Händlers verweisen.

Beispiel: 

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

rating_url xs:anyURI Erforderlich (1) URL der Landingpage, auf der die Rezensionen für diesen Händler gehostet werden.
Verwenden Sie keine Weiterleitungs-URL.

Beispiel: 

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

create_timestamp DateTimeWithTimeZone Erforderlich (1) Uhrzeit und Datum, zu dem der Händler erstellt wurde. Daran sollte sich nichts ändern.
last_update_timestamp DateTimeWithTimeZone Erforderlich (1) Uhrzeit und Datum der letzten Aktualisierung des Händlers. Wenn eines der Felder im Element <merchant> für eine bestimmte Händler-ID aktualisiert wird, muss sich auch dieser Wert ändern.

<deleted_merchants>

Beschreibung

Container für gelöschte Händler.

Enthält

Name Format Häufigkeit Beschreibung
deleted_merchant       -- Erforderlich (1–n) Enthält Elemente, die sich auf einen einzelnen gelöschten Händler beziehen.

<deleted_merchant>

Beschreibung

Der Händler wurde gelöscht.

Attribute

Name Format Häufigkeit Beschreibung
id Id Erforderlich (1) Gibt die ID eines Händlers an, der aus dem Feed gelöscht werden soll. Die ID muss mit dem Attribut id eines <merchant>-Elements in einer vorherigen Feeddatei übereinstimmen.

Enthält

Name Format Häufigkeit Beschreibung
last_update_timestamp DateTimeWithTimeZone Erforderlich (1) Uhrzeit und Datum, zu denen ein Händler aus dem System entfernt wurde.

Beispiel: 

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

Beispiel

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

<reviews>

Beschreibung

Container für <review>-Elemente.

Enthält

Name Format Häufigkeit Beschreibung
review       -- Erforderlich (1–n) Das Element wird für jede Rezension wiederholt.

<review>

Beschreibung

Container für Details zu einer Rezension.

Attribute

Name Format Häufigkeit Beschreibung
id Id Erforderlich (1) Die Kennung für eine Rezension in Ihrem System. Muss für alle Feeds eindeutig und stabil sein.

Beispiel: 

<review id=132739 mid=1234>

mid Id Erforderlich (1) Die ID des Händlers, für den diese Rezension gilt.

Enthält

Bitte fügen Sie die folgenden Elemente in das Rezensionselement ein.

Name Format Häufigkeit Beschreibung
reviewer_name NonEmptyString Optional (0–1) Der angezeigte Name des Autors der Rezension, sofern die Rezension einen Namen haben soll. Bei anonymen Rezensionen sollte dieses Feld nicht angegeben werden.

Beispiel: 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp DateTimeWithTimeZone Erforderlich (1) Uhrzeit und Datum, zu denen die Rezension vom Nutzer eingereicht wurde. Daran sollte sich nichts ändern.

Beispiel: 

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

last_update_timestamp DateTimeWithTimeZone Erforderlich (1) Uhrzeit/Datum der letzten Änderung der Informationen im <review>-Element. Wenn eines der Felder im Element <review> für eine bestimmte Rezensions-ID aktualisiert wird, muss sich auch dieser Wert ändern.

Beispiel: 

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

country_code CountryCode Erforderlich (1) Land des Rezensenten. Falls verfügbar, ist dies das Land, in das das Produkt geliefert bzw. in dem die Dienstleistung erbracht wurde. Andernfalls verwenden Sie das Land, in dem sich der Rezensent zum Zeitpunkt der Erstellung der Rezension befand. Der Ländercode muss im Format ISO 3166-1 alpha-2 angegeben werden.

Beispiel: 

  <country_code>
    US
  </country_code>

title xs:string Optional (0–1) Der Titel der Rezension. Der Titel sollte nur Text ohne HTML-Tags enthalten.

Beispiel: 

  <title>
    Great prices
  </title>

content xs:string Erforderlich (1) Der Inhalt der Rezension. Dies sollte ein beliebiger Freiformtext sein, der vom Nutzer angegeben wird, und darf nicht gekürzt werden. Der Inhalt sollte nur Text ohne HTML-Tags sein. Ein Zeilenumbruch sollte beispielsweise durch ein Zeilenvorschubzeichen und nicht durch ein <br>-Tag dargestellt werden. Wenn mehrere Antworten auf verschiedene Fragen angegeben werden, sollten alle Antworten mit dem minimalen Kontext enthalten sein, damit sie sinnvoll sind. Kontext sollte nicht angegeben werden, wenn Fragen unbeantwortet geblieben sind.

Beispiel: 

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

Beispiel: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings           -- Erforderlich (1) Containerelement für die Bewertungen des Händlers durch den Rezensenten. Wenn für das <overall>-Element keine Bewertung verfügbar ist, sollte die gesamte zugehörige Rezension aus dem Feed ausgeschlossen werden, da das <overall>-Element erforderlich ist und die Rezension ohne dieses Element nicht akzeptiert wird.
collection_method CollectionMethodType Erforderlich (1) Die Methode, mit der die Rezension erfasst wurde. Der Wert muss einer der folgenden sein:
  • Unaufgefordert: Der Nutzer hat die Rezension ohne eine bestimmte Aufforderung gepostet.
  • point_of_sale: Der Nutzer hat die Rezension aufgrund einer Aufforderung gepostet, nachdem er eine Bestellung aufgegeben hat.
  • after_fulfillment: Der Nutzer hat die Rezension aufgrund einer Aufforderung gepostet, nachdem seine Bestellung ausgeführt wurde.

Beispiel: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Beschreibung

Enthält die Bewertungen des Händlers durch den Rezensenten. Wenn für das <overall>-Element keine Bewertung verfügbar ist, sollte die gesamte zugehörige Rezension aus dem Feed ausgeschlossen werden, da das <overall>-Element erforderlich ist und die Rezension ohne dieses Element nicht akzeptiert wird.

Enthält

Bitte fügen Sie dem Element „ratings“ die folgenden Elemente hinzu.

Name Format Häufigkeit Beschreibung
overall RatingRange Erforderlich (1) Die Gesamtbewertung eines Rezensenten für einen Händler.

Beispiel: 

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

customer_service RatingRange Optional (0–1) Bewertung des Rezensenten für die Qualität des Kundenservice dieses Händlers.

Beispiel: 

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

<deleted_reviews>

Beschreibung

Container für gelöschte Rezensionen.

Enthält

Name Format Häufigkeit Beschreibung
deleted_review       -- Erforderlich (1–n) Enthält Elemente, die sich auf eine einzelne gelöschte Rezension beziehen.

<deleted_review>

Beschreibung

Gelöschte Rezension

Attribute

Name Format Häufigkeit Beschreibung
id Id Erforderlich (1) Gibt die ID einer Rezension an, die aus dem Feed gelöscht werden soll. Die ID muss mit dem Attribut „id“ eines <review>-Elements in einer beliebigen Feeddatei übereinstimmen.

Enthält

Name Format Häufigkeit Beschreibung
last_update_timestamp DateTimeWithTimeZone Erforderlich (1) Zeitpunkt, zu dem eine Rezension aus dem System entfernt wurde.

Beispiel: 

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

Beispiel

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