Package google.shopping.merchant.reviews.v1beta

Indeks

MerchantReviewsService

Usługa do zarządzania opiniami o sprzedawcy.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

Usuwa opinię o sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

Pobiera opinię o sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

Wstawia opinię o koncie Merchant Center. Jeśli opinia już istnieje, zostanie zastąpiona nową.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

Wyświetla opinie o sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

ProductReviewsService

Usługa do zarządzania opiniami o produktach.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

Usuwa opinię o produkcie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

Pobiera opinię o produkcie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

Wstawia opinię o produkcie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

Wyświetla opinie o produktach.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

DeleteMerchantReviewRequest

Żądanie wiadomości dla metody DeleteMerchantReview.

Pola
name

string

Wymagane. Identyfikator opinii o sprzedawcy. Format: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

Żądanie wiadomości dla metody DeleteProductReview.

Pola
name

string

Wymagane. Identyfikator opinii o produkcie. Format: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

Żądanie wiadomości dla metody GetMerchantReview.

Pola
name

string

Wymagane. Identyfikator opinii o sprzedawcy. Format: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

Treść żądania dla metody GetProductReview.

Pola
name

string

Wymagane. Identyfikator opinii o sprzedawcy. Format: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

Żądanie wiadomości dla metody InsertMerchantReview.

Pola
parent

string

Wymagane. Konto, na którym zostanie wstawiona opinia sprzedawcy. Format: accounts/{account}
merchant_review

MerchantReview

Wymagane. Opinia sprzedawcy do wstawienia.
data_source

string

Wymagane. Źródło danych merchantreview: format accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

Żądanie wiadomości dla metody InsertProductReview.

Pola
parent

string

Wymagane. Konto, na którym zostanie wstawiona opinia o produkcie. Format: accounts/{account}
product_review

ProductReview

Wymagane. Opinia o produkcie do wstawienia.
data_source

string

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

ListMerchantReviewsRequest

Żądanie wiadomości dla metody ListMerchantsReview.

Pola
parent

string

Wymagane. Konto, na którym mają być wyświetlane opinie sprzedawców. Format: accounts/{account}
page_size

int32

Opcjonalnie: Maksymalna liczba opinii sprzedawcy do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Maksymalna wartość to 1000; wartości powyżej 1000 są przymusowo ustawiane na 1000. Jeśli nie określisz tej wartości, zwrócona zostanie maksymalna liczba opinii.
page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji ListMerchantReviews. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji ListMerchantReviews muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListMerchantReviewsResponse

wiadomość z odpowiedzią dla metody ListMerchantsReview.

Pola
merchant_reviews[]

MerchantReview

Opinia sprzedawcy.
next_page_token

string

Token do pobierania następnej strony wyników.

ListProductReviewsRequest

Komunikat o żądaniu dotyczący metody ListProductReviews.

Pola
parent

string

Wymagane. Konto, na którym mają się wyświetlać opinie o produktach. Format: accounts/{account}
page_size

int32

Opcjonalnie: Maksymalna liczba produktów do zwrócenia. Usługa może zwrócić mniej niż ta wartość.
page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji ListProductReviews. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji ListProductReviews muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListProductReviewsResponse

wiadomość odpowiedzi dla metody ListProductReviews.

Pola
product_reviews[]

ProductReview

Opinia o produkcie.
next_page_token

string

token, który może być wysyłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

MerchantReview

opinia o sprzedawcy, Więcej informacji znajdziesz w artykule Wprowadzenie do plików danych opinii o sprzedawcy.

Pola
name

string

Identyfikator. Nazwa opinii o sprzedawcy. Format: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchant_review_id

string

Wymagane. Użytkownik podał identyfikator opinii o sprzedawcy, aby jednoznacznie zidentyfikować opinię.
attributes

MerchantReviewAttributes

Opcjonalnie: Lista atrybutów opinii o sprzedawcy.
custom_attributes[]

CustomAttribute

Wymagane. Lista atrybutów niestandardowych (podanych przez sprzedawcę). Można go też używać do przesyłania dowolnego atrybutu specyfikacji danych w formie ogólnej (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są jawnie udostępniane przez interfejs API, np. atrybutów eksperymentalnych. Maksymalna dozwolona liczba znaków dla każdego atrybutu niestandardowego to 10240 (co odpowiada sumie znaków w nazwie i wartości). Na produkt można ustawić maksymalnie 2500 atrybutów niestandardowych o łącznym rozmiarze 102, 4 KB. Podkreślenia w nazwach atrybutów niestandardowych są zastępowane spacjami podczas wstawiania.
data_source

string

Tylko dane wyjściowe. Podstawowe źródło danych opinii sprzedawcy.
merchant_review_status

MerchantReviewStatus

Tylko dane wyjściowe. stan opinii o sprzedawcy, problemy z weryfikacją danych, czyli informacje o opinii o sprzedawcy obliczone asynchronicznie;

MerchantReviewAttributes

Atrybuty.

Pola
merchant_id

string

Wymagane. Musi być unikalny i stabilny we wszystkich żądaniach. Inaczej mówiąc, jeśli prośba z dzisiejszego dnia i prośba sprzed 90 dni odnoszą się do tego samego sprzedawcy, muszą mieć ten sam identyfikator.
merchant_display_name

string

Opcjonalnie: Wyświetlana nazwa sprzedawcy w formie czytelnej dla człowieka.
min_rating

int64

Opcjonalnie: Minimalna możliwa liczba dla oceny. Jest to najgorsza możliwa ocena i nie powinna być wartością oznaczającą brak oceny.
max_rating

int64

Opcjonalnie: Maksymalna możliwa liczba dla oceny. Wartość maksymalnej oceny musi być większa niż wartość minimalnej oceny.
rating

double

Opcjonalnie: Ogólna ocena sprzedawcy przez użytkownika.
title

string

Opcjonalnie: Tytuł recenzji.
content

string

Wymagane. Powinien to być dowolny tekst dostarczony przez użytkownika, który nie może być obcinany. Jeśli podasz wiele odpowiedzi na różne pytania, należy uwzględnić wszystkie odpowiedzi wraz z minimalnym kontekstem, aby były one zrozumiałe. Jeśli pytania nie zostały przez Ciebie udzielone, nie podawaj kontekstu.
reviewer_id

string

Opcjonalnie: Trwały, unikalny identyfikator autora opinii w systemie wydawcy.
reviewer_username

string

Opcjonalnie: Wyświetlana nazwa autora recenzji.
is_anonymous

bool

Opcjonalnie: Ustaw na „PRAWDA”, jeśli recenzent ma pozostać anonimowy.
collection_method

CollectionMethod

Opcjonalnie: Metoda zbierania opinii.
review_time

Timestamp

Wymagane. Sygnatura czasowa określająca, kiedy opinia została wystawiona.
review_language

string

Wymagane. Język opinii określony za pomocą kodu języka BCP-47.
review_country

string

Opcjonalnie: Kraj, w którym autor recenzji złożył zamówienie, określony za pomocą kodu kraju zgodnego ze standardem ISO 3166-1 alfa-2.

CollectionMethod

Metoda zbierania opinii.

Wartości w polu enum
COLLECTION_METHOD_UNSPECIFIED Nieokreślony sposób gromadzenia opinii.
MERCHANT_UNSOLICITED Użytkownik przesłał opinię bez żadnej konkretnej zachęty.
POINT_OF_SALE Użytkownik przesłał opinię w odpowiedzi na prośbę po złożeniu zamówienia.
AFTER_FULFILLMENT Użytkownik przesłał opinię w odpowiedzi na prośbę po zrealizowaniu zamówienia.

MerchantReviewStatus

stan opinii o sprzedawcy, problemy z weryfikacją danych, czyli informacje o opinii o sprzedawcy obliczone asynchronicznie;

Pola
destination_statuses[]

MerchantReviewDestinationStatus

Tylko dane wyjściowe. Przeznaczenie opinii o sprzedawcy.
item_level_issues[]

MerchantReviewItemLevelIssue

Tylko dane wyjściowe. Lista wszystkich problemów związanych z opinią o sprzedawcy.
create_time

Timestamp

Tylko dane wyjściowe. Data utworzenia elementu w formacie ISO 8601.
last_update_time

Timestamp

Tylko dane wyjściowe. Data ostatniej aktualizacji elementu w formacie ISO 8601.

MerchantReviewDestinationStatus

Stan weryfikacji sprzedawcy w miejscu docelowym.

Pola
reporting_context

ReportingContextEnum

Tylko dane wyjściowe. Nazwa kontekstu raportowania.

MerchantReviewItemLevelIssue

Stan weryfikacji sprzedawcy pod kątem problemu na poziomie produktu.

Pola
code

string

Tylko dane wyjściowe. Kod błędu.
severity

Severity

Tylko dane wyjściowe. Jak ten problem wpływa na wyświetlanie opinii o sprzedawcy.
resolution

string

Tylko dane wyjściowe. Czy problem może zostać rozwiązany przez sprzedawcę.
attribute

string

Tylko dane wyjściowe. nazwę atrybutu, jeśli problem jest spowodowany przez pojedynczy atrybut.
reporting_context

ReportingContextEnum

Tylko dane wyjściowe. Kontekst raportowania, w którym występuje problem.
description

string

Tylko dane wyjściowe. Krótki opis problemu w języku angielskim.
detail

string

Tylko dane wyjściowe. szczegółowy opis problemu w języku angielskim.
documentation

string

Tylko dane wyjściowe. adres URL strony internetowej, która pomoże nam rozwiązać ten problem.

Poziom ważności

Jak problem wpływa na wyświetlanie opinii o sprzedawcy.

Wartości w polu enum
SEVERITY_UNSPECIFIED Nie określono.
NOT_IMPACTED Ten problem jest ostrzeżeniem i nie ma bezpośredniego wpływu na weryfikację sprzedawcy.
DISAPPROVED Problem powoduje odrzucenie opinii sprzedawcy.

ProductReview

Opinia o produkcie. Więcej informacji znajdziesz w artykule Wprowadzenie do plików danych z opiniami o produktach.

Pola
name

string

Identyfikator. Nazwa recenzji produktu. Format: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
product_review_id

string

Wymagane. Trwały, unikalny identyfikator opinii o produkcie w systemie wydawcy.
attributes

ProductReviewAttributes

Opcjonalnie: Lista atrybutów opinii o produkcie.
custom_attributes[]

CustomAttribute

Opcjonalnie: Lista atrybutów niestandardowych (podanych przez sprzedawcę).
data_source

string

Tylko dane wyjściowe. Główne źródło danych opinii o produkcie.
product_review_status

ProductReviewStatus

Tylko dane wyjściowe. stan opinii o produkcie, problemy z weryfikacją danych, czyli informacje o opinii o produkcie obliczone asynchronicznie.

ProductReviewAttributes

Atrybuty.

Pola
review_time

Timestamp

Wymagane. Sygnatura czasowa określająca, kiedy opinia została wystawiona.
pros[]

string

Opcjonalnie: Zawiera zalety oparte na opinii recenzenta. Pomiń tekst standardowy, np. „pro:”, chyba że został napisany przez autora opinii.
cons[]

string

Opcjonalnie: Zawiera wady oparte na opinii recenzenta. Pomiń tekst standardowy, np. „con:”, chyba że został napisany przez autora opinii.
product_names[]

string

Opcjonalnie: Nazwa opisowa produktu.
asins[]

string

Opcjonalnie: Zawiera ASIN (standardowe numery identyfikacyjne Amazon) powiązane z produktem.
gtins[]

string

Opcjonalnie: Zawiera numery GTIN (globalne numery jednostek handlowych) powiązane z produktem. Obsługiwane są podtypy numerów GTIN (np. UPC, EAN, ISBN, JAN).
mpns[]

string

Opcjonalnie: Zawiera numery katalogowe producenta (MPN) powiązane z produktem.
skus[]

string

Opcjonalnie: Zawiera kody SKU (jednostki magazynowe) powiązane z produktem. Często jest to identyczne z identyfikatorem oferty produktu w pliku danych o produktach.
brands[]

string

Opcjonalnie: Zawiera nazwy marek powiązane z produktem.
collection_method

CollectionMethod

Opcjonalnie: Metoda zbierania opinii.
transaction_id

string

Opcjonalnie: Trwały, unikalny identyfikator transakcji powiązanej z opinią w systemie wydawcy. Ten identyfikator może być używany do wskazywania, że z tą samą transakcją powiązane są różne opinie.
aggregator_name

string

Opcjonalnie: Nazwa agregatora opinii o produktach.

Wydawca może korzystać z pośrednika gromadzącego opinie, aby zarządzać opiniami i udostępniać pliki danych. Ten element wskazuje na użycie agregatora i zawiera informacje o nim.
subclient_name

string

Opcjonalnie: Nazwa podklienta, którego dotyczą opinie o produktach.

Podklient to identyfikator źródła opinii o produkcie. Powinien być katalogiem podanym w ścieżce źródła danych pliku.
publisher_name

string

Opcjonalnie: Nazwa wydawcy opinii o produkcie.

informacje o wydawcy, którym może być sprzedawca, producent, firma świadcząca usługi związane z opiniami lub dowolny podmiot publikujący opinie o produktach;
publisher_favicon

string

Opcjonalnie: link do ikony firmy wydawcy. Wymiary obrazu powinny odpowiadać rozmiarowi ikony favicon: 16 x 16 pikseli. Format obrazu powinien być GIF, JPG lub PNG.
reviewer_id

string

Opcjonalnie: Autor opinii o produkcie.

Trwały, unikalny identyfikator autora opinii w systemie wydawcy.
reviewer_is_anonymous

bool

Opcjonalnie: Ustaw na „PRAWDA”, jeśli recenzent ma pozostać anonimowy.
reviewer_username

string

Opcjonalnie: Imię i nazwisko osoby, która napisała opinię o produkcie.
review_language

string

Opcjonalnie: Język opinii określony za pomocą kodu języka BCP-47.
review_country

string

Opcjonalnie: Kraj, w którym znajduje się obiekt, którego dotyczy opinia, zdefiniowany za pomocą dwuliterowego kodu kraju zgodnego ze standardem ISO 3166-1 alfa-2.
title

string

Opcjonalnie: Tytuł recenzji.
content

string

Wymagane. Treść opinii.
min_rating

int64

Opcjonalnie: Zawiera oceny powiązane z opinią. Minimalna możliwa liczba dla oceny. Jest to najgorsza możliwa ocena i nie może być wartością oznaczającą brak oceny.
max_rating

int64

Opcjonalnie: Maksymalna możliwa liczba dla oceny. Wartość atrybutu max rating musi być większa niż wartość atrybutu min.
rating

double

Opcjonalnie: Ogólna ocena produktu przez recenzenta.
is_spam

bool

Opcjonalnie: Wskazuje, czy opinia została oznaczona jako spam w systemie wydawcy.

CollectionMethod

Metoda zbierania opinii.

Wartości w polu enum
COLLECTION_METHOD_UNSPECIFIED Nieokreślony sposób gromadzenia opinii.
UNSOLICITED Użytkownik przesłał opinię bez żadnej konkretnej zachęty.
POST_FULFILLMENT Użytkownik przesłał opinię w odpowiedzi na prośbę po zrealizowaniu zamówienia.

Typ

Typ identyfikatora URI weryfikacji.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ.
SINGLETON Strona z opiniami zawiera tylko tę jedną opinię.
GROUP Strona opinii zawiera grupę opinii, w tym tę opinię.

ProductReviewStatus

Stan opinii o produkcie.

Pola
destination_statuses[]

ProductReviewDestinationStatus

Tylko dane wyjściowe. Miejsca docelowe opinii o produkcie.
item_level_issues[]

ProductReviewItemLevelIssue

Tylko dane wyjściowe. Lista wszystkich problemów związanych z opinią o produkcie.
create_time

Timestamp

Tylko dane wyjściowe. Data utworzenia elementu w formacie ISO 8601.
last_update_time

Timestamp

Tylko dane wyjściowe. Data ostatniej aktualizacji elementu w formacie ISO 8601.

ProductReviewDestinationStatus

Stan docelowy opinii o produkcie.

Pola
reporting_context

ReportingContextEnum

Tylko dane wyjściowe. Nazwa kontekstu raportowania.

ProductReviewItemLevelIssue

Stan weryfikacji produktu w kontekście problemu na poziomie produktu.

Pola
code

string

Tylko dane wyjściowe. Kod błędu.
severity

Severity

Tylko dane wyjściowe. W jaki sposób ten problem wpływa na wyświetlanie opinii o produkcie.
resolution

string

Tylko dane wyjściowe. Czy problem może zostać rozwiązany przez sprzedawcę.
attribute

string

Tylko dane wyjściowe. nazwę atrybutu, jeśli problem jest spowodowany przez pojedynczy atrybut.
reporting_context

ReportingContextEnum

Tylko dane wyjściowe. Kontekst raportowania, w którym występuje problem.
description

string

Tylko dane wyjściowe. Krótki opis problemu w języku angielskim.
detail

string

Tylko dane wyjściowe. szczegółowy opis problemu w języku angielskim.
documentation

string

Tylko dane wyjściowe. adres URL strony internetowej, która pomoże nam rozwiązać ten problem.

Poziom ważności

Jak problem wpływa na wyświetlanie opinii o produkcie.

Wartości w polu enum
SEVERITY_UNSPECIFIED Nie określono.
NOT_IMPACTED Ten problem jest ostrzeżeniem i nie ma bezpośredniego wpływu na opinię o produkcie.
DISAPPROVED Problem powoduje odrzucenie opinii o produkcie.