Package google.shopping.merchant.reviews.v1beta

Index

MerchantReviewsService

Dienst zum Verwalten von Händlerrezensionen.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

Händlerrezension wird gelöscht.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

Ruft eine Händlerbewertung ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

Fügen Sie eine Überprüfung für Ihr Merchant Center-Konto ein. Wenn die Rezension bereits vorhanden ist, wird sie durch die neue Instanz ersetzt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

Hier werden Händlerrezensionen aufgeführt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ProductReviewsService

Dienst zum Verwalten von Produktrezensionen.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

Löscht eine Produktrezension.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

Eine Produktrezension wird abgerufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

Hier wird eine Produktrezension eingefügt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

Listet Rezensionen auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

DeleteMerchantReviewRequest

Anfragenachricht für die Methode DeleteMerchantReview.

Felder
name

string

Erforderlich. Die ID der Händlerrezension. Format: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

Anfragenachricht für die Methode DeleteProductReview.

Felder
name

string

Erforderlich. Die ID der Produktrezension. Format: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

Anfragenachricht für die Methode GetMerchantReview.

Felder
name

string

Erforderlich. Die ID der Händlerrezension. Format: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

Anfragenachricht für die Methode „GetProductReview“.

Felder
name

string

Erforderlich. Die ID der Händlerrezension. Format: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

Anfragenachricht für die Methode InsertMerchantReview.

Felder
parent

string

Erforderlich. Das Konto, in das die Händlerrezension eingefügt werden soll. Format: accounts/{account}
merchant_review

MerchantReview

Erforderlich. Die einzufügende Händlerbewertung.
data_source

string

Erforderlich. Die Datenquelle des merchantreview-Formats: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

Anfragenachricht für die Methode InsertProductReview.

Felder
parent

string

Erforderlich. Das Konto, in das die Rezension eingefügt werden soll. Format: accounts/{account}
product_review

ProductReview

Erforderlich. Die einzufügende Produktrezension.
data_source

string

Erforderlich. Format: accounts/{account}/dataSources/{datasource}.

ListMerchantReviewsRequest

Anfragenachricht für die Methode ListMerchantsReview.

Felder
parent

string

Erforderlich. Das Konto, für das Händlerrezensionen aufgeführt werden sollen. Format: accounts/{account}
page_size

int32

Optional. Die maximale Anzahl der Händlerrezensionen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. Wenn nichts angegeben ist, wird die maximale Anzahl von Rezensionen zurückgegeben.
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListMerchantReviews-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListMerchantReviews bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListMerchantReviewsResponse

Antwortnachricht für die Methode ListMerchantsReview.

Felder
merchant_reviews[]

MerchantReview

Die Händlerrezension.
next_page_token

string

Das Token, mit dem die nächste Ergebnisseite abgerufen werden kann.

ListProductReviewsRequest

Anfragenachricht für die Methode „ListProductReviews“.

Felder
parent

string

Erforderlich. Das Konto, für das Produktrezensionen aufgeführt werden sollen. Format: accounts/{account}
page_size

int32

Optional. Die maximale Anzahl der Produkte, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListProductReviews-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListProductReviews bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListProductReviewsResponse

Antwortnachricht für die Methode „ListProductReviews“.

Felder
product_reviews[]

ProductReview

Die Produktrezension.
next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

MerchantReview

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

Felder
name

string

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

string

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

MerchantReviewAttributes

Optional. Eine Liste der Attribute für Händlerrezensionen.
custom_attributes[]

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.
data_source

string

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

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

Felder
merchant_id

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.
merchant_display_name

string

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

int64

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

int64

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

double

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.
reviewer_id

string

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

string

Optional. Der Anzeigename des Rezensenten.
is_anonymous

bool

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

CollectionMethod

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

Timestamp

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

string

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

string

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

CollectionMethod

Die Methode, mit der die Rezension erfasst wurde.

Enums
COLLECTION_METHOD_UNSPECIFIED Erfassungsmethode nicht angegeben.
MERCHANT_UNSOLICITED 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.

MerchantReviewStatus

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

Felder
destination_statuses[]

MerchantReviewDestinationStatus

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

MerchantReviewItemLevelIssue

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

Timestamp

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

Timestamp

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

MerchantReviewDestinationStatus

Der Zielstatus des Rezensionsstatus des Händlers.

Felder
reporting_context

ReportingContextEnum

Nur Ausgabe. Der Name des Berichtskontexts.

MerchantReviewItemLevelIssue

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

Felder
code

string

Nur Ausgabe. Der Fehlercode des Problems
severity

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.
reporting_context

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 Die Händlerrezension wird aufgrund des Problems abgelehnt.

ProductReview

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

Felder
name

string

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

string

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

ProductReviewAttributes

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

CustomAttribute

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

string

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

ProductReviewStatus

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

ProductReviewAttributes

Attribute

Felder
review_time

Timestamp

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

string

Optional. Enthält die Vorteile aus Sicht des Rezensenten. 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.
product_names[]

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. Häufig stimmt sie mit der Angebots-ID des Produkts im Produktfeed überein.
brands[]

string

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

CollectionMethod

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

string

Optional. Eine dauerhafte, eindeutige Kennung für die Transaktion, die im System des Publishers mit der Rezension verknüpft ist. Mit dieser ID kann angegeben werden, dass mehrere Rezensionen mit derselben Transaktion verknüpft sind.
aggregator_name

string

Optional. Der Name des Aggregators der Produktrezensionen.

Ein Verlag oder Webpublisher kann 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.
subclient_name

string

Optional. Der Name des Unterkundens der Produktrezensionen.

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

string

Optional. Der Name des Publishers der Produktrezensionen.

Informationen zum Publisher, z. B. ein Einzelhändler, ein Hersteller, ein Unternehmen, das Rezensionsdienste anbietet, oder eine andere Entität, die Produktrezensionen veröffentlicht.
publisher_favicon

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.
reviewer_id

string

Optional. Der Autor der Produktrezension.

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

bool

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

string

Optional. Der Name des Rezensenten der Produktrezension.
review_language

string

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

string

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

string

Optional. Der Titel der Rezension.
content

string

Erforderlich. Der Inhalt der Rezension.
min_rating

int64

Optional. Enthält die mit der Rezension verknüpften Bewertungen. Die niedrigste mögliche Bewertung. Dies sollte die schlechteste mögliche Bewertung sein und kein Wert für „keine Bewertung“.
max_rating

int64

Optional. Die höchstmögliche Bewertung. Der Wert des Attributs „Höchstbewertung“ muss größer als der Wert des Attributs „Mindestbewertung“ sein.
rating

double

Optional. Die Gesamtbewertung des Produkts durch den Rezensenten.
is_spam

bool

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

CollectionMethod

Die Methode, mit der die Rezension erfasst wurde.

Enums
COLLECTION_METHOD_UNSPECIFIED Erfassungsmethode nicht angegeben.
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.

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.

ProductReviewStatus

Status der Produktrezension.

Felder
destination_statuses[]

ProductReviewDestinationStatus

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

ProductReviewItemLevelIssue

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

Timestamp

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

Timestamp

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

ProductReviewDestinationStatus

Der Zielstatus des Status der Produktrezension.

Felder
reporting_context

ReportingContextEnum

Nur Ausgabe. Der Name des Berichtskontexts.

ProductReviewItemLevelIssue

Das Problem auf Artikelebene des Status der Produktüberprüfung.

Felder
code

string

Nur Ausgabe. Der Fehlercode des Problems
severity

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.
reporting_context

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