Package google.shopping.merchant.reviews.v1beta

Indeks

MerchantReviewsService

Layanan untuk mengelola ulasan penjual.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

Menghapus ulasan penjual.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

Mendapatkan ulasan penjual.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

Menyisipkan ulasan untuk akun Merchant Center Anda. Jika ulasan sudah ada, ulasan akan diganti dengan instance baru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

Mencantumkan ulasan penjual.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ProductReviewsService

Layanan untuk mengelola ulasan produk.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

Menghapus ulasan produk.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

Mendapatkan ulasan produk.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

Menyisipkan ulasan produk.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

Mencantumkan ulasan produk.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

DeleteMerchantReviewRequest

Pesan permintaan untuk metode DeleteMerchantReview.

Kolom
name

string

Wajib. ID ulasan penjual. Format: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

Pesan permintaan untuk metode DeleteProductReview.

Kolom
name

string

Wajib. ID Ulasan produk. Format: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

Pesan permintaan untuk metode GetMerchantReview.

Kolom
name

string

Wajib. ID ulasan penjual. Format: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

Pesan permintaan untuk metode GetProductReview.

Kolom
name

string

Wajib. ID ulasan penjual. Format: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

Pesan permintaan untuk metode InsertMerchantReview.

Kolom
parent

string

Wajib. Akun tempat ulasan penjual akan disisipkan. Format: accounts/{account}

merchant_review

MerchantReview

Wajib. Ulasan penjual yang akan disisipkan.

data_source

string

Wajib. Sumber data Format merchantreview: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

Pesan permintaan untuk metode InsertProductReview.

Kolom
parent

string

Wajib. Akun tempat ulasan produk akan disisipkan. Format: accounts/{account}

product_review

ProductReview

Wajib. Ulasan produk yang akan disisipkan.

data_source

string

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

ListMerchantReviewsRequest

Pesan permintaan untuk metode ListMerchantsReview.

Kolom
parent

string

Wajib. Akun yang akan mencantumkan ulasan penjual. Format: accounts/{account}

page_size

int32

Opsional. Jumlah maksimum ulasan penjual yang akan ditampilkan. Layanan dapat menampilkan lebih sedikit dari nilai ini. Nilai maksimumnya adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000. Jika tidak ditentukan, jumlah maksimum ulasan akan ditampilkan.

page_token

string

Opsional. Token halaman, diterima dari panggilan ListMerchantReviews sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListMerchantReviews harus sesuai dengan panggilan yang menyediakan token halaman.

ListMerchantReviewsResponse

Pesan respons untuk metode ListMerchantsReview.

Kolom
merchant_reviews[]

MerchantReview

Ulasan penjual.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

ListProductReviewsRequest

Pesan permintaan untuk metode ListProductReviews.

Kolom
parent

string

Wajib. Akun yang akan mencantumkan ulasan produk. Format: accounts/{account}

page_size

int32

Opsional. Jumlah produk maksimum yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

page_token

string

Opsional. Token halaman, diterima dari panggilan ListProductReviews sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListProductReviews harus sesuai dengan panggilan yang menyediakan token halaman.

ListProductReviewsResponse

pesan respons untuk metode ListProductReviews.

Kolom
product_reviews[]

ProductReview

Ulasan produk.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

MerchantReview

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

Kolom
name

string

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

merchant_review_id

string

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

attributes

MerchantReviewAttributes

Opsional. Daftar atribut ulasan penjual.

custom_attributes[]

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 ditampilkan 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). Maksimal 2.500 atribut kustom dapat ditetapkan per produk, dengan ukuran total 102,4 KB. Garis bawah dalam nama atribut kustom akan diganti dengan spasi saat disisipkan.

data_source

string

Hanya output. Sumber data utama ulasan penjual.

merchant_review_status

MerchantReviewStatus

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

MerchantReviewAttributes

Atribut.

Kolom
merchant_id

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.

merchant_display_name

string

Opsional. Nama tampilan yang dapat dibaca manusia untuk penjual.

min_rating

int64

Opsional. Jumlah minimum untuk rating. Nilai ini harus berupa rating terburuk dan tidak boleh berupa nilai untuk tidak ada rating.

max_rating

int64

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

rating

double

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 respons untuk pertanyaan yang berbeda diberikan, semua respons harus disertakan, dengan konteks minimal agar respons tersebut masuk akal. Konteks tidak boleh diberikan jika pertanyaan tidak terjawab.

reviewer_id

string

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

reviewer_username

string

Opsional. Nama tampilan penulis ulasan.

is_anonymous

bool

Opsional. Tetapkan ke benar jika pengulas harus tetap anonim.

collection_method

CollectionMethod

Opsional. Metode yang digunakan untuk mengumpulkan ulasan.

review_time

Timestamp

Wajib. Stempel waktu yang menunjukkan kapan ulasan ditulis.

review_language

string

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

review_country

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 mengirimkan ulasan tanpa diminta.
POINT_OF_SALE Pengguna mengirimkan ulasan sebagai respons atas permintaan saat pengguna melakukan pemesanan.
AFTER_FULFILLMENT Pengguna mengirimkan ulasan sebagai respons atas permintaan setelah pesanan pengguna dipenuhi.

MerchantReviewStatus

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

Kolom
destination_statuses[]

MerchantReviewDestinationStatus

Hanya output. Tujuan yang dimaksudkan untuk ulasan penjual.

item_level_issues[]

MerchantReviewItemLevelIssue

Hanya output. Daftar semua masalah yang terkait dengan ulasan penjual.

create_time

Timestamp

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

last_update_time

Timestamp

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

MerchantReviewDestinationStatus

Status tujuan status ulasan penjual.

Kolom
reporting_context

ReportingContextEnum

Hanya output. Nama konteks pelaporan.

MerchantReviewItemLevelIssue

ItemLevelIssue dari status peninjauan penjual.

Kolom
code

string

Hanya output. Kode error masalah.

severity

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.

reporting_context

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 memiliki dampak langsung pada ulasan penjual.
DISAPPROVED Masalah tidak menyetujui ulasan penjual.

ProductReview

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

Kolom
name

string

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

product_review_id

string

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

attributes

ProductReviewAttributes

Opsional. Daftar atribut ulasan produk.

custom_attributes[]

CustomAttribute

Opsional. Daftar atribut khusus (disediakan penjual).

data_source

string

Hanya output. Sumber data utama ulasan produk.

product_review_status

ProductReviewStatus

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

ProductReviewAttributes

Atribut.

Kolom
review_time

Timestamp

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.

product_names[]

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 pabrik) 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.

collection_method

CollectionMethod

Opsional. Metode yang digunakan untuk mengumpulkan ulasan.

transaction_id

string

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

aggregator_name

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.

subclient_name

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.

publisher_name

string

Opsional. Nama penerbit ulasan produk.

Informasi tentang penayang, yang dapat berupa retailer, produsen, perusahaan layanan ulasan, atau entitas apa pun yang memublikasikan ulasan produk.

publisher_favicon

string

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

reviewer_id

string

Opsional. Penulis ulasan produk.

ID unik permanen untuk penulis ulasan di sistem penayang.

reviewer_is_anonymous

bool

Opsional. Tetapkan ke benar jika pengulas harus tetap anonim.

reviewer_username

string

Opsional. Nama peninjau ulasan produk.

review_language

string

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

review_country

string

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

title

string

Opsional. Judul ulasan.

content

string

Wajib. Konten ulasan.

min_rating

int64

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.

max_rating

int64

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

rating

double

Opsional. Rating keseluruhan produk dari peninjau.

is_spam

bool

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

CollectionMethod

Metode yang digunakan untuk mengumpulkan ulasan.

Enum
COLLECTION_METHOD_UNSPECIFIED Metode pengumpulan tidak ditentukan.
UNSOLICITED Pengguna mengirimkan ulasan tanpa diminta.
POST_FULFILLMENT Pengguna mengirimkan ulasan sebagai respons atas permintaan setelah pesanan pengguna dipenuhi.

Jenis

Jenis URI ulasan.

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

ProductReviewStatus

Status peninjauan produk.

Kolom
destination_statuses[]

ProductReviewDestinationStatus

Hanya output. Tujuan yang dimaksudkan untuk ulasan produk.

item_level_issues[]

ProductReviewItemLevelIssue

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

create_time

Timestamp

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

last_update_time

Timestamp

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

ProductReviewDestinationStatus

Status tujuan status peninjauan produk.

Kolom
reporting_context

ReportingContextEnum

Hanya output. Nama konteks pelaporan.

ProductReviewItemLevelIssue

ItemLevelIssue dari status peninjauan produk.

Kolom
code

string

Hanya output. Kode error masalah.

severity

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.

reporting_context

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.