REST Resource: accounts.merchantReviews

Resource: MerchantReview

Ulasan untuk penjual. Untuk mengetahui informasi selengkapnya, lihat Pengantar Feed Ulasan Merchant

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

string

ID. Nama ulasan penjual. Format: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

Wajib. Pengguna memberikan ID ulasan penjual untuk mengidentifikasi ulasan penjual secara unik.
attributes

object (MerchantReviewAttributes)

Opsional. Daftar atribut ulasan penjual.
customAttributes[]

object (CustomAttribute)

Wajib. Daftar atribut khusus (disediakan penjual). Atribut ini juga dapat digunakan untuk mengirimkan atribut spesifikasi data dalam bentuk generik (misalnya, { "name": "size type", "value": "regular" }). Hal ini berguna untuk mengirimkan atribut yang tidak diekspos secara eksplisit oleh API, seperti atribut eksperimental. Jumlah karakter maksimum yang diizinkan untuk setiap atribut kustom adalah 10240 (mewakili jumlah karakter untuk nama dan nilai). Maksimum 2.500 atribut khusus dapat ditetapkan per produk, dengan ukuran total 102,4 kB. Garis bawah dalam nama atribut kustom akan diganti dengan spasi saat disisipkan.
dataSource

string

Hanya output. Sumber data utama ulasan penjual.
merchantReviewStatus

object (MerchantReviewStatus)

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

MerchantReviewAttributes

Atribut.

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

string

Wajib. Harus unik dan stabil di semua permintaan. Dengan kata lain, jika permintaan hari ini dan permintaan 90 hari yang lalu merujuk ke penjual yang sama, permintaan tersebut harus memiliki ID yang sama.
merchantDisplayName

string

Opsional. Nama tampilan yang dapat dibaca manusia untuk penjual.
minRating

string (int64 format)

Opsional. Jumlah minimum untuk rating. Ini harus berupa rating terburuk dan tidak boleh menjadi nilai untuk tanpa rating.
maxRating

string (int64 format)

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

number

Opsional. Rating keseluruhan penjual dari peninjau.
title

string

Opsional. Judul ulasan.
content

string

Wajib. Ini harus berupa teks bebas format yang diberikan oleh pengguna dan tidak boleh terpotong. Jika beberapa jawaban atas pertanyaan yang berbeda diberikan, semua respons harus disertakan, dengan konteks minimal agar respons tersebut masuk akal. Konteks tidak boleh diberikan jika pertanyaan tidak terjawab.
reviewerId

string

Opsional. ID unik permanen untuk penulis ulasan di sistem penayang.
reviewerUsername

string

Opsional. Nama tampilan penulis ulasan.
isAnonymous

boolean

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

enum (CollectionMethod)

Opsional. Metode yang digunakan untuk mengumpulkan ulasan.
reviewTime

string (Timestamp format)

Wajib. Stempel waktu yang menunjukkan kapan ulasan ditulis.
reviewLanguage

string

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

string

Opsional. Negara tempat peninjau membuat urutan yang ditentukan oleh Kode Negara ISO 3166-1 Alpha-2.

CollectionMethod

Metode yang digunakan untuk mengumpulkan ulasan.

Enum
COLLECTION_METHOD_UNSPECIFIED Metode pengumpulan tidak ditentukan.
MERCHANT_UNSOLICITED Pengguna tidak merespons permintaan tertentu saat mengirimkan ulasan.
POINT_OF_SALE Pengguna mengirimkan ulasan sebagai respons atas permintaan saat pengguna melakukan pemesanan.
AFTER_FULFILLMENT Pengguna mengirimkan ulasan sebagai respons atas permintaan setelah fulfillment pesanan pengguna.

MerchantReviewStatus

Status ulasan penjual, masalah validasi data, yaitu informasi tentang ulasan penjual yang dihitung secara asinkron.

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

object (MerchantReviewDestinationStatus)

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

object (MerchantReviewItemLevelIssue)

Hanya output. Daftar semua masalah yang terkait dengan ulasan penjual.
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.

MerchantReviewDestinationStatus

Status tujuan status ulasan penjual.

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

enum (ReportingContextEnum)

Hanya output. Nama konteks pelaporan.

MerchantReviewItemLevelIssue

ItemLevelIssue dari status peninjauan penjual.

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 penjual.
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 ini terhadap penayangan ulasan penjual.

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

Metode

delete

 Menghapus ulasan penjual.

get

 Mendapatkan ulasan penjual.

insert

 Menyisipkan ulasan untuk akun Merchant Center Anda.

list

 Mencantumkan ulasan penjual.