REST Resource: accounts.productReviews

Resource: ProductReview

Ulasan untuk produk. Untuk informasi selengkapnya, lihat Pengantar Feed Ulasan Produk

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

string

ID. Nama ulasan produk. Format: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

Wajib. ID unik permanen untuk ulasan produk di sistem penayang.
attributes

object (ProductReviewAttributes)

Opsional. Daftar atribut ulasan produk.
customAttributes[]

object (CustomAttribute)

Opsional. Daftar atribut khusus (disediakan penjual).
dataSource

string

Hanya output. Sumber data utama ulasan produk.
productReviewStatus

object (ProductReviewStatus)

Hanya output. Status ulasan produk, masalah validasi data, yaitu informasi tentang ulasan produk yang dihitung secara asinkron.

ProductReviewAttributes

Atribut.

Representasi 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
}
Kolom
reviewTime

string (Timestamp format)

Wajib. Stempel waktu yang menunjukkan kapan ulasan ditulis.
pros[]

string

Opsional. Berisi kelebihan berdasarkan pendapat peninjau. Hapus teks boilerplate seperti "pro:" kecuali jika ditulis oleh peninjau.
cons[]

string

Opsional. Berisi kekurangan berdasarkan pendapat peninjau. Hapus teks boilerplate seperti "con:" kecuali jika ditulis oleh peninjau.
productNames[]

string

Opsional. Nama deskriptif produk.
asins[]

string

Opsional. Berisi ASIN (Amazon Standard Identification Numbers) yang terkait dengan produk.
gtins[]

string

Opsional. Berisi GTIN (nomor item perdagangan global) yang terkait dengan produk. Subjenis GTIN (misalnya UPC, EAN, ISBN, JAN) didukung.
mpns[]

string

Opsional. Berisi MPN (nomor suku cadang produsen) yang terkait dengan produk.
skus[]

string

Opsional. Berisi SKU (unit penyimpanan stok) yang terkait dengan produk. Sering kali ID ini cocok dengan ID Penawaran produk di feed produk.
brands[]

string

Opsional. Berisi nama merek yang terkait dengan produk.
collectionMethod

enum (CollectionMethod)

Opsional. Metode yang digunakan untuk mengumpulkan ulasan.
transactionId

string

Opsional. ID unik permanen untuk transaksi yang terkait dengan ulasan di sistem penerbit. ID ini dapat digunakan untuk menunjukkan bahwa beberapa ulasan dikaitkan dengan transaksi yang sama.
aggregatorName

string

Opsional. Nama agregator ulasan produk.

Penayang dapat menggunakan agregator ulasan untuk mengelola ulasan dan menyediakan feed. Elemen ini menunjukkan penggunaan agregator dan berisi informasi tentang agregator.
subclientName

string

Opsional. Nama subklien ulasan produk.

Subklien adalah ID sumber ulasan produk. Direktori ini harus setara dengan direktori yang diberikan di jalur sumber data file.
publisherName

string

Opsional. Nama penerbit ulasan produk.

Informasi tentang penerbit, yang dapat berupa retailer, produsen, perusahaan jasa ulasan, atau entitas apa pun yang memublikasikan ulasan produk.
publisherFavicon

string

Opsional. Link ke favicon perusahaan penerbit. Dimensi gambar harus berukuran favicon: 16x16 piksel. Format gambar harus GIF, JPG, atau PNG.
reviewerId

string

Opsional. Penulis ulasan produk.

ID unik permanen untuk penulis ulasan di sistem penayang.
reviewerIsAnonymous

boolean

Opsional. Tetapkan ke benar jika pengulas harus tetap anonim.
reviewerUsername

string

Opsional. Nama peninjau ulasan produk.
reviewLanguage

string

Opsional. Bahasa ulasan yang ditentukan oleh kode bahasa BCP-47.
reviewCountry

string

Opsional. Negara ulasan yang ditentukan oleh Kode Negara ISO 3166-1 Alpha-2.
title

string

Opsional. Judul ulasan.
content

string

Wajib. Konten ulasan.
minRating

string (int64 format)

Opsional. Berisi rating yang terkait dengan ulasan. Jumlah minimum untuk rating. Nilai ini harus berupa rating terburuk dan tidak boleh berupa nilai untuk tidak ada rating.
maxRating

string (int64 format)

Opsional. Jumlah maksimum untuk rating. Nilai rating maksimum harus lebih besar dari nilai atribut minimum.
rating

number

Opsional. Rating keseluruhan dari pengulas untuk produk.
isSpam

boolean

Opsional. Menunjukkan apakah ulasan ditandai sebagai spam di sistem penayang.

Jenis

Jenis URI ulasan.

Enum
TYPE_UNSPECIFIED Jenis tidak ditentukan.
SINGLETON Halaman ulasan hanya berisi satu ulasan ini.
GROUP Halaman ulasan berisi grup ulasan termasuk ulasan ini.

CollectionMethod

Metode yang digunakan untuk mengumpulkan ulasan.

Enum
COLLECTION_METHOD_UNSPECIFIED Metode pengumpulan tidak ditentukan.
UNSOLICITED Pengguna tidak merespons permintaan tertentu saat mengirimkan ulasan.
POST_FULFILLMENT Pengguna mengirimkan ulasan sebagai respons atas permintaan setelah fulfillment pesanan pengguna.

ProductReviewStatus

Status peninjauan produk.

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

object (ProductReviewDestinationStatus)

Hanya output. Tujuan yang dimaksudkan untuk ulasan produk.
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

Hanya output. Daftar semua masalah yang terkait dengan ulasan produk.
createTime

string (Timestamp format)

Hanya output. Tanggal item dibuat, dalam format ISO 8601.
lastUpdateTime

string (Timestamp format)

Hanya output. Tanggal item terakhir diperbarui, dalam format ISO 8601.

ProductReviewDestinationStatus

Status tujuan status peninjauan produk.

Representasi JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
Kolom
reportingContext

enum (ReportingContextEnum)

Hanya output. Nama konteks pelaporan.

ProductReviewItemLevelIssue

ItemLevelIssue status peninjauan produk.

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

string

Hanya output. Kode error masalah.
severity

enum (Severity)

Hanya output. Pengaruh masalah ini terhadap penayangan ulasan produk.
resolution

string

Hanya output. Apakah masalah dapat diselesaikan oleh penjual.
attribute

string

Hanya output. Nama atribut, jika masalahnya disebabkan oleh satu atribut.
reportingContext

enum (ReportingContextEnum)

Hanya output. Konteks pelaporan tempat masalah diterapkan.
description

string

Hanya output. Deskripsi singkat masalah dalam bahasa Inggris.
detail

string

Hanya output. Deskripsi masalah mendetail dalam bahasa Inggris.
documentation

string

Hanya output. URL halaman web untuk membantu menyelesaikan masalah ini.

Keparahan

Pengaruh masalah terhadap penayangan ulasan produk.

Enum
SEVERITY_UNSPECIFIED Tidak ditentukan.
NOT_IMPACTED Masalah ini merupakan peringatan dan tidak berdampak langsung pada ulasan produk.
DISAPPROVED Masalah menolak ulasan produk.

Metode

delete

 Menghapus ulasan produk.

get

 Mendapatkan ulasan produk.

insert

 Menyisipkan ulasan produk.

list

 Mencantumkan ulasan produk.