REST Resource: accounts.merchantReviews

Zasób: MerchantReview

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

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

string

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

string

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

object (MerchantReviewAttributes)

Opcjonalnie: Lista atrybutów związanych z opiniami o sprzedawcy.
customAttributes[]

object (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). Dla każdego produktu można ustawić maksymalnie 2500 atrybutów niestandardowych o łącznym rozmiarze 102, 4 kB. Podkreślenia w nazwach atrybutów niestandardowych są zastępowane podczas wstawiania przez spacje.
dataSource

string

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

object (MerchantReviewStatus)

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

MerchantReviewAttributes

Atrybuty.

Zapis JSON 
{
  "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
}
Pola
merchantId

string

Wymagane. Musi być unikalny i niezmienny 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.
merchantDisplayName

string

Opcjonalnie: Czytelna nazwa wyświetlana sprzedawcy.
minRating

string (int64 format)

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

string (int64 format)

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

number

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

string

Opcjonalnie: Tytuł opinii.
content

string

Wymagane. Powinien to być dowolny tekst dostarczony przez użytkownika, który nie może być obcinany. Jeśli podano wiele odpowiedzi na różne pytania, należy uwzględnić wszystkie odpowiedzi. Należy podać minimalny kontekst, aby odpowiedzi były przydatne. Nie należy podawać kontekstu, jeśli na pytanie nie podano odpowiedzi.
reviewerId

string

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

string

Opcjonalnie: Wyświetlana nazwa autora opinii.
isAnonymous

boolean

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

enum (CollectionMethod)

Opcjonalnie: Metoda zbierania opinii.
reviewTime

string (Timestamp format)

Wymagane. Sygnatura czasowa wskazująca, kiedy opinia została napisana.
reviewLanguage

string

Wymagane. Język opinii zdefiniowany przez kod języka BCP-47.
reviewCountry

string

Opcjonalnie: Kraj, w którym osoba sprawdzająca złożyła zamówienie, zgodnie z kodem kraju w formacie 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 nie odpowiadał na konkretne zachęty, gdy przesłał opinię.
POINT_OF_SALE Użytkownik przesłał opinię w odpowiedzi na prośbę o ocenę, która pojawiła się podczas składania 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;

Zapis JSON 
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Pola
destinationStatuses[]

object (MerchantReviewDestinationStatus)

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

object (MerchantReviewItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

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

MerchantReviewDestinationStatus

Stan docelowy w weryfikacji sprzedawcy.

Zapis JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
Pola
reportingContext

enum (ReportingContextEnum)

Tylko dane wyjściowe. Nazwa kontekstu raportowania.

MerchantReviewItemLevelIssue

Stan weryfikacji sprzedawcy w ramach problemu na poziomie produktu.

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

string

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

enum (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. Nazwa atrybutu, jeśli problem jest spowodowany przez jeden atrybut.
reportingContext

enum (ReportingContextEnum)

Tylko dane wyjściowe. Kontekst raportowania, którego dotyczy 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

W jaki sposób problem wpływa na wyświetlanie opinii o sprzedawcy.

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

Metody

delete

 Usuwa opinię o sprzedawcy.

get

 Pobiera opinię sprzedawcy.

insert

 Wstawia opinię na temat Twojego konta Merchant Center.

list

 Wyświetla opinie o sprzedawcy.