REST Resource: accounts.merchantReviews

Ressource: MerchantReview

Eine Rezension für einen Händler. Weitere Informationen finden Sie unter Einführung in Feeds mit Händlerrezensionen.

JSON-Darstellung 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
Felder
name

string

Kennung. Der Name der Händlerrezension. Format: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

Erforderlich. Die vom Nutzer angegebene Händlerrezensions-ID, um die Händlerrezension eindeutig zu identifizieren.
attributes

object (MerchantReviewAttributes)

Optional. Eine Liste der Attribute für Händlerbewertungen.
customAttributes[]

object (CustomAttribute)

Erforderlich. Eine Liste von benutzerdefinierten (vom Händler bereitgestellten) Attributen. Sie kann auch zum Einreichen beliebiger Attribute der Datenspezifikation in ihrer generischen Form (z. B. { "name": "size type", "value": "regular" }) verwendet werden. Das ist nützlich, um Attribute einzureichen, die nicht explizit von der API bereitgestellt werden, z. B. experimentelle Attribute. Die maximale Anzahl von Zeichen für jedes benutzerdefinierte Attribut beträgt 10.240 (Summe der Zeichen für Name und Wert). Pro Produkt können maximal 2.500 benutzerdefinierte Attribute mit einer Gesamtgröße von 102, 4 KB festgelegt werden. Unterstriche in benutzerdefinierten Attributnamen werden beim Einfügen durch Leerzeichen ersetzt.
dataSource

string

Nur Ausgabe. Die primäre Datenquelle der Händlerrezension.
merchantReviewStatus

object (MerchantReviewStatus)

Nur Ausgabe. Der Status einer Händlerrezension, Probleme bei der Datenvalidierung, d. h. Informationen zu einer Händlerrezension, die asynchron berechnet werden.

MerchantReviewAttributes

Attribute

JSON-Darstellung 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
Felder
merchantId

string

Erforderlich. Muss für alle Anfragen eindeutig und unveränderlich sein. Wenn sich eine Anfrage heute und eine vor 90 Tagen auf denselben Händler beziehen, müssen sie dieselbe ID haben.
merchantDisplayName

string

Optional. Der für Menschen lesbare Anzeigename des Händlers.
minRating

string (int64 format)

Optional. Die Mindestanzahl für die Bewertung. Dies sollte die schlechteste mögliche Bewertung sein und darf nicht der Wert für „keine Bewertung“ sein.
maxRating

string (int64 format)

Optional. Die höchstmögliche Bewertung. Der Wert der maximalen Bewertung muss größer als der Wert der minimalen Bewertung sein.
rating

number

Optional. Die Gesamtbewertung des Händlers durch den Rezensenten.
title

string

Optional. Der Titel der Rezension.
content

string

Erforderlich. Dies sollte ein beliebiger vom Nutzer eingegebener Freiformtext sein und darf nicht abgeschnitten werden. Wenn mehrere Antworten auf verschiedene Fragen gegeben werden, sollten alle Antworten mit dem minimalen Kontext enthalten sein, damit die Antworten einen Sinn ergeben. Kontext sollte nicht angegeben werden, wenn Fragen unbeantwortet geblieben sind.
reviewerId

string

Optional. Eine dauerhafte, eindeutige Kennung für den Rezensenten im System des Verlags oder Webpublishers.
reviewerUsername

string

Optional. Der Anzeigename des Rezensenten.
isAnonymous

boolean

Optional. Legen Sie „wahr“ fest, wenn der Rezensent anonym bleiben soll.
collectionMethod

enum (CollectionMethod)

Optional. Die Methode, mit der die Rezension erfasst wurde.
reviewTime

string (Timestamp format)

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

string

Erforderlich. Die Sprache der Rezension, wie durch den BCP-47-Sprachcode definiert.
reviewCountry

string

Optional. Das Land, in dem der Prüfer die Bestellung gemäß ISO 3166-1 Alpha-2-Ländercode aufgegeben hat.

CollectionMethod

Die Methode, mit der die Rezension erfasst wurde.

Enums
COLLECTION_METHOD_UNSPECIFIED Erfassungsmethode nicht angegeben.
MERCHANT_UNSOLICITED Der Nutzer hat die Rezension nicht auf eine bestimmte Aufforderung hin gepostet.
POINT_OF_SALE Der Nutzer hat die Rezension als Antwort auf eine Aufforderung gesendet, als er eine Bestellung aufgegeben hat.
AFTER_FULFILLMENT Der Nutzer hat die Rezension als Reaktion auf eine Aufforderung nach der Ausführung seiner Bestellung eingereicht.

MerchantReviewStatus

Der Status einer Händlerrezension, Probleme bei der Datenvalidierung, d. h. Informationen zu einer Händlerrezension, die asynchron berechnet werden.

JSON-Darstellung 
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Felder
destinationStatuses[]

object (MerchantReviewDestinationStatus)

Nur Ausgabe. Die vorgesehenen Ziele der Händlerrezension.
itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

Nur Ausgabe. Eine Liste aller Probleme im Zusammenhang mit der Händlerüberprüfung.
createTime

string (Timestamp format)

Nur Ausgabe. Das Datum, an dem der Artikel erstellt wurde. Die Angabe erfolgt im ISO 8601-Format.
lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Datum der letzten Aktualisierung des Artikels. Die Angabe erfolgt im ISO 8601-Format.

MerchantReviewDestinationStatus

Der Zielstatus des Status der Händlerrezension.

JSON-Darstellung 
{
  "reportingContext": enum (ReportingContextEnum)
}
Felder
reportingContext

enum (ReportingContextEnum)

Nur Ausgabe. Der Name des Berichtskontexts.

MerchantReviewItemLevelIssue

Das Problem auf Artikelebene des Überprüfungsstatus des Händlers.

JSON-Darstellung 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
Felder
code

string

Nur Ausgabe. Der Fehlercode des Problems
severity

enum (Severity)

Nur Ausgabe. Wie sich dieses Problem auf die Zustellung der Händlerrezension auswirkt.
resolution

string

Nur Ausgabe. Ob das Problem vom Händler behoben werden kann.
attribute

string

Nur Ausgabe. Der Attributname, falls das Problem durch ein einzelnes Attribut verursacht wird.
reportingContext

enum (ReportingContextEnum)

Nur Ausgabe. Der Berichtskontext, auf den sich das Problem bezieht.
description

string

Nur Ausgabe. Eine kurze Problembeschreibung in Englisch.
detail

string

Nur Ausgabe. Ausführliche Problembeschreibung in Englisch.
documentation

string

Nur Ausgabe. Die URL einer Webseite, die bei der Lösung des Problems helfen kann.

Schweregrad

Wie sich das Problem auf die Auslieferung der Händlerrezension auswirkt.

Enums
SEVERITY_UNSPECIFIED Nicht angegeben.
NOT_IMPACTED Dieses Problem ist eine Warnung und hat keine direkten Auswirkungen auf die Überprüfung des Händlers.
DISAPPROVED Aufgrund dieses Problems wird die Händlerrezension abgelehnt.

Methoden

delete

 Händlerrezension wird gelöscht.

get

 Ruft eine Händlerbewertung ab.

insert

 Fügen Sie eine Rezension für Ihr Merchant Center-Konto ein.

list

 Listet Händlerrezensionen auf.