REST Resource: accounts.productReviews

Zasób: ProductReview

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

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

string

Identyfikator. Nazwa opinii o produkcie. Format: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

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

object (ProductReviewAttributes)

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

object (CustomAttribute)

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

string

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

object (ProductReviewStatus)

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

ProductReviewAttributes

Atrybuty.

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

string (Timestamp format)

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 określone na podstawie opinii recenzenta. Pomiń tekst standardowy, np. „con:”, chyba że został napisany przez autora opinii.
productNames[]

string

Opcjonalnie: Opisowa nazwa 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.
collectionMethod

enum (CollectionMethod)

Opcjonalnie: Metoda użyta do zbierania opinii.
transactionId

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ą liczne opinie.
aggregatorName

string

Opcjonalnie: Nazwa agregatora opinii o produkcie.

Wydawca może korzystać z pośrednika gromadzącego opinie, aby zarządzać opiniami i dostarczać pliki danych. Ten element wskazuje wykorzystanie agregatora i zawiera informacje o nim.
subclientName

string

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

Podklient to identyfikator źródła opinii o produkcie. Powinien on być katalogiem odpowiadającym katalogowi podanemu w ścieżce źródła danych pliku.
publisherName

string

Opcjonalnie: Nazwa wydawcy opinii o produktach.

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

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

string

Opcjonalnie: Autor opinii o produkcie.

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

boolean

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

string

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

string

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

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ł opinii.
content

string

Wymagane. Treść opinii.
minRating

string (int64 format)

Opcjonalnie: Zawiera oceny powiązane z opinią. 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 wartość oceny. Wartość atrybutu max rating musi być większa niż wartość atrybutu min.
rating

number

Opcjonalnie: Ogólna ocena produktu przez recenzenta.
isSpam

boolean

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

Typ

Typ identyfikatora URI weryfikacji.

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

CollectionMethod

Metoda zbierania opinii.

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

ProductReviewStatus

Stan opinii o produkcie.

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

object (ProductReviewDestinationStatus)

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

object (ProductReviewItemLevelIssue)

Tylko dane wyjściowe. Lista wszystkich problemów związanych z opinią o produkcie.
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.

ProductReviewDestinationStatus

Stan docelowy opinii o produkcie.

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

enum (ReportingContextEnum)

Tylko dane wyjściowe. Nazwa kontekstu raportowania.

ProductReviewItemLevelIssue

Stan weryfikacji produktu w kontekście 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 produkcie.
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, 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 stanowi ostrzeżenie i nie ma bezpośredniego wpływu na opinię o produkcie.
DISAPPROVED Problem powoduje odrzucenie opinii o produkcie.

Metody

delete

 Usuwa opinię o produkcie.

get

 Pobiera opinię o produkcie.

insert

 Wstawia opinię o produkcie.

list

 Wyświetla opinie o produktach.