Method: accounts.locations.batchGetReviews

Menampilkan daftar ulasan bernomor halaman untuk semua lokasi yang ditentukan. Operasi ini hanya valid jika lokasi yang ditentukan diverifikasi.

Permintaan HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama akun tempat mengambil daftar ulasan di beberapa lokasi.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Kolom
locationNames[]

string

Kumpulan lokasi yang ulasannya akan diambil, yang ditentukan berdasarkan namanya.

pageSize

integer

Berapa banyak ulasan yang akan diambil per halaman. Nilai defaultnya adalah 50.

pageToken

string

Jika ditentukan, ini akan mengambil halaman ulasan berikutnya.

orderBy

string

Opsional. Menentukan kolom pengurutan ulasan. Jika tidak ditentukan, urutan ulasan yang ditampilkan akan ditetapkan secara default ke updateTime desc. Urutan valid yang digunakan untuk mengurutkan adalah rating, rating desc, dan updateTime desc. rating akan menampilkan ulasan dalam urutan menaik. updateTime(yaitu urutan menaik) tidak didukung.

ignoreRatingOnlyReviews
(deprecated)

boolean

Apakah akan mengabaikan ulasan hanya rating atau tidak.

Isi respons

Pesan respons untuk Reviews.BatchGetReviews.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Kolom
locationReviews[]

object (LocationReview)

Ulasan dengan informasi lokasi.

nextPageToken

string

Jika jumlah ulasan melampaui ukuran halaman yang diminta, kolom ini diisi dengan token untuk mengambil halaman ulasan berikutnya pada panggilan selanjutnya. Jika tidak ada lagi ulasan, kolom ini tidak akan ada dalam respons.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

LocationReview

Merepresentasikan ulasan dengan informasi lokasi.

Representasi JSON
{
  "name": string,
  "review": {
    object (Review)
  }
}
Kolom
name

string

Nama resource lokasi.

review

object (Review)

Ulasan untuk lokasi.