XML-Schema

In diesem Abschnitt wird das XML-Schema beschrieben, das für den Datenfeed für Händlerrezensionen verwendet wird.

Element der obersten Ebene: <feed>

Beschreibung

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

Attribute

Name Formatieren Häufigkeit Beschreibung
xmlns xs:String Erforderlich (1) Bitte hartcodieren Sie den folgenden Wert:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:String Erforderlich (1) Bitte hartcodieren Sie den folgenden Wert:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:String Erforderlich (1) Bitte hartcodieren Sie den folgenden Wert und lassen Sie zwischen URLs ein leeres Leerzeichen:
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 Formatieren 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 Formatieren Häufigkeit Beschreibung
merchant -- Erforderlich (1–n) Element für jeden Händler wiederholt.

<merchant>

Beschreibung

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

Attribute

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

Beispiel

<merchant id="2739">

„enthält“

Fügen Sie die folgenden Elemente in das Händlerelement ein.

Name Formatieren Häufigkeit Beschreibung
name NonEmptyString Erforderlich (1) Für Menschen lesbarer Anzeigename für den Händler.
merchant_url xs:anyURI. Erforderlich (1) URL der Hauptwebsite des Händlers
Für diesen Wert darf keine Weiterleitungs-URL verwendet werden. 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.
Verwende keine Weiterleitungs-URL.

Beispiel: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>
create_timestamp Datum/Uhrzeit Erforderlich (1) Datum und Uhrzeit der Erstellung des Händlers. Das sollte sich nie ändern.
last_update_timestamp Datum/Uhrzeit Erforderlich (1) Uhrzeit/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 dieser Wert ebenfalls ändern.

<deleted_merchants>

Beschreibung

Container für Händler, die gelöscht wurden.

„enthält“

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

<deleted_merchant>

Beschreibung

Händler, der gelöscht wurde.

Attribute

Name Formatieren 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 id-Attribut eines <merchant>-Elements in einer früheren Feeddatei übereinstimmen.

„enthält“

Name Formatieren Häufigkeit Beschreibung
last_update_timestamp Datum/Uhrzeit Erforderlich (1) Zeitpunkt (Datum/Uhrzeit), zu dem 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 Formatieren 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 Formatieren 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 Kennzeichnung des Händlers, für den diese Rezension gilt.

„enthält“

Bitte fügen Sie dem Rezensionselement die folgenden Elemente hinzu.

Name Formatieren Häufigkeit Beschreibung
reviewer_name NonEmptyString Optional (0–1) Anzeigename des Autors der Rezension, vorausgesetzt, die Rezension muss einen benannten Autor haben. Anonyme Rezensionen dürfen dieses Feld nicht enthalten.

Beispiel: 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp Datum/Uhrzeit Erforderlich (1) Uhrzeit/Datum, an dem die Rezension vom Nutzer eingereicht wurde. Das sollte sich nie ändern.

Beispiel: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp Datum/Uhrzeit Erforderlich (1) Uhrzeit/Datum, an dem die Informationen im Element <review> zuletzt geändert wurden. Wenn eines der Felder im Element <review> für eine bestimmte Rezensions-ID aktualisiert wird, muss sich dieser Wert ebenfalls ändern.

Beispiel: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>
country_code CountryCode Erforderlich (1) Land des Rezensenten. Sofern verfügbar, ist dies das Land, in das das Produkt geliefert wurde oder in dem die Dienstleistung erbracht wurde. Andernfalls können Sie das Land angeben, in dem sich der Prüfer befindet. Der Ländercode muss das Format ISO 3166-1 alpha-2 haben.

Beispiel: 

  <country_code>
    US
  </country_code>
title xs:String Optional (0–1) Der Titel der Rezension. Er sollte nur Text enthalten und darf keine HTML-Tags enthalten.

Beispiel: 

  <title>
    Great prices
  </title>
content xs:String Erforderlich (1) Der Inhalt der Rezension. Dies sollte ein vom Nutzer bereitgestellter freier Text sein und darf nicht gekürzt werden. Der Inhalt sollte im Nur-Text-Format vorliegen und keine HTML-Tags enthalten. Beispielsweise sollte ein Zeilenumbruch durch ein Zeilenvorschubzeichen und nicht durch ein <ph type="x-smartling-placeholder"></ph>-Tag dargestellt werden. Wenn Sie mehrere Antworten auf unterschiedliche Fragen zur Verfügung stellen, sollten Sie alle Antworten mit dem minimalen Kontext hinzufügen, der für die Antwort sinnvoll ist. Der Kontext sollte nicht angegeben werden, wenn die Fragen unbeantwortet blieben.

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 Element <overall> keine Bewertung verfügbar ist, sollte die gesamte zugehörige Rezension aus dem Feed ausgeschlossen werden, da das Element <overall> erforderlich ist und die Rezension ohne dieses Element nicht akzeptiert wird.
collection_method CollectionMethodType Erforderlich (1) Die Methode, mit der die Rezension erfasst wurde. Folgende Werte sind zulässig:
  • unaufgefordert: Der Nutzer hat beim Senden der Rezension nicht auf eine bestimmte Anfrage reagiert.
  • Point_of_sale: Der Nutzer hat die Rezension als Antwort auf eine Aufforderung gesendet, als der Nutzer eine Bestellung aufgegeben hat.
  • After_fulfillment: Der Nutzer hat die Rezension nach einer Auftragserfüllung gesendet.

Beispiel: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Beschreibung

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

„enthält“

Bitte füge die folgenden Elemente in das Bewertungselement ein.

Name Formatieren Häufigkeit Beschreibung
overall RatingRange Erforderlich (1) Gesamtbewertung des Rezensenten für einen Händler.

Beispiel: 

  <overall min="1" max="10">9</overall>
customer_service RatingRange Optional (0–1) Bewertung des Kundenservice des Händlers durch den Prüfer.

Beispiel: 

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

<deleted_reviews>

Beschreibung

Container für Rezensionen, die gelöscht wurden.

„enthält“

Name Formatieren Häufigkeit Beschreibung
deleted_review -- Erforderlich (1–n) Enthält Element(e), die mit einer einzelnen gelöschten Rezension zusammenhängen.

<deleted_review>

Beschreibung

Prüfen Sie, welche gelöscht wurde.

Attribute

Name Formatieren 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 ID-Attribut eines <review>-Elements in einer Feeddatei übereinstimmen.

„enthält“

Name Formatieren Häufigkeit Beschreibung
last_update_timestamp Datum/Uhrzeit 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>