REST Resource: accounts.productReviews

Ressource: ProductReview

Eine Rezension für ein Produkt. Weitere Informationen finden Sie unter Einführung in Feeds mit Rezensionen.

JSON-Darstellung 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
Felder
name

string

Kennung. Der Name der Produktrezension. Format: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

Erforderlich. Die dauerhafte, eindeutige Kennzeichnung für die Rezension im System des Publishers.
attributes

object (ProductReviewAttributes)

Optional. Eine Liste der Attribute für Rezensionen.
customAttributes[]

object (CustomAttribute)

Optional. Eine Liste von benutzerdefinierten (vom Händler bereitgestellten) Attributen.
dataSource

string

Nur Ausgabe. Die primäre Datenquelle der Rezension.
productReviewStatus

object (ProductReviewStatus)

Nur Ausgabe. Der Status einer Rezension, Probleme mit der Datenvalidierung, d. h. Informationen zu einer Rezension, die asynchron berechnet werden.

ProductReviewAttributes

Attribute

JSON-Darstellung 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Felder
reviewTime

string (Timestamp format)

Erforderlich. Der Zeitstempel, der angibt, wann die Rezension verfasst wurde.
pros[]

string

Optional. Die auf der Meinung der prüfenden Person basierenden Vorteile enthalten. Lassen Sie Textbausteine wie „Vorteile:“ weg, es sei denn, sie wurden vom Rezensenten verfasst.
cons[]

string

Optional. Enthält die Nachteile aus Sicht des Rezensenten. Entfernen Sie Textbausteine wie „Nachteil:“, es sei denn, sie wurden vom Rezensenten verfasst.
productNames[]

string

Optional. Ein aussagekräftiger Name für ein Produkt.
asins[]

string

Optional. Enthält ASINs (Amazon Standard Identification Numbers), die mit einem Produkt verknüpft sind.
gtins[]

string

Optional. 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[]

string

Optional. Enthält MPNs (Teilenummern des Herstellers), die mit einem Produkt verknüpft sind.
skus[]

string

Optional. Enthält SKUs (Artikelnummern), die mit einem Produkt verknüpft sind. Diese Angabe stimmt häufig mit der Produktfeed-ID im Produktfeed überein.
brands[]

string

Optional. Enthält Markennamen, die mit einem Produkt verknüpft sind.
collectionMethod

enum (CollectionMethod)

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

string

Optional. Eine dauerhafte, eindeutige Kennung 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.
aggregatorName

string

Optional. Der Name des Aggregators der Produktrezensionen.

Publisher können einen Dienstleister für Rezensionen verwenden, um Rezensionen zu verwalten und die Feeds bereitzustellen. Dieses Element gibt an, dass ein Dienstleister verwendet wird, und enthält Informationen zu diesem Dienstleister.
subclientName

string

Optional. Der Name des Subkunden der Rezensionen.

Der untergeordnete Kunde ist eine Kennung der Quelle der Produktrezension. Es sollte dem Verzeichnis entsprechen, das im Pfad der Dateidatenquelle angegeben ist.
publisherName

string

Optional. Der Name des Publishers der Produktrezensionen.

Die Informationen zum Publisher. Das kann ein Einzelhändler, Hersteller, ein Dienstleistungsunternehmen für Rezensionen oder ein anderes Rechtssubjekt sein, das Rezensionen veröffentlicht.
publisherFavicon

string

Optional. Ein Link zum Favicon des Unternehmens des Publishers. Die Bildabmessungen sollten der Größe eines Favicons entsprechen: 16 × 16 Pixel. Das Bildformat sollte GIF, JPG oder PNG sein.
reviewerId

string

Optional. Der Autor der Produktrezension.

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

boolean

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

string

Optional. Der Name des Rezensenten der Rezension.
reviewLanguage

string

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

string

Optional. Das Land der Rezension, definiert durch den ISO 3166-1 Alpha-2-Ländercode.
title

string

Optional. Der Titel der Rezension.
content

string

Erforderlich. Der Inhalt der Rezension.
minRating

string (int64 format)

Optional. Enthält die mit der Rezension verknüpften Bewertungen. 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 des Attributs „Höchstbewertung“ muss größer als der Wert des Attributs „Mindestbewertung“ sein.
rating

number

Optional. Die Gesamtbewertung des Produkts durch den Rezensenten.
isSpam

boolean

Optional. Gibt an, ob die Rezension im System des Publishers als Spam gekennzeichnet wurde.

Typ

Der Typ des Rezensions-URIs.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
SINGLETON Die Rezensionsseite enthält nur diese einzelne Rezension.
GROUP Die Rezensionsseite enthält eine Gruppe von Rezensionen, darunter diese Rezension.

CollectionMethod

Die Methode, mit der die Rezension erfasst wurde.

Enums
COLLECTION_METHOD_UNSPECIFIED Erfassungsmethode nicht angegeben.
UNSOLICITED Der Nutzer hat die Rezension nicht auf eine bestimmte Aufforderung hin gepostet.
POST_FULFILLMENT Der Nutzer hat die Rezension als Reaktion auf eine Aufforderung nach der Ausführung seiner Bestellung eingereicht.

ProductReviewStatus

Status der Produktrezension.

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

object (ProductReviewDestinationStatus)

Nur Ausgabe. Die vorgesehenen Ziele der Produktrezension.
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

Nur Ausgabe. Eine Liste aller Probleme im Zusammenhang mit der Produktrezension.
createTime

string (Timestamp format)

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

string (Timestamp format)

Nur Ausgabe. Datum, an dem der Artikel zuletzt aktualisiert wurde. Die Angabe erfolgt im ISO 8601-Format.

ProductReviewDestinationStatus

Der Zielstatus des Überprüfungsstatus des Produkts.

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

enum (ReportingContextEnum)

Nur Ausgabe. Der Name des Berichtskontexts.

ProductReviewItemLevelIssue

Das „ItemLevelIssue“-Wert des Rezensionsstatus.

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 Auslieferung der Produktrezension 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 auf 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 Rezension auswirkt.

Enums
SEVERITY_UNSPECIFIED Nicht angegeben.
NOT_IMPACTED Dieses Problem ist eine Warnung und hat keine direkten Auswirkungen auf die Produktrezension.
DISAPPROVED Aufgrund des Problems wird die Produktrezension abgelehnt.

Methoden

delete

 Löscht eine Produktrezension.

get

 Eine Produktrezension wird abgerufen.

insert

 Fügen Sie eine Produktrezension ein.

list

 Listet Rezensionen auf.