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 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 harus diambil per halaman. Nilai defaultnya adalah 50.

pageToken

string

Jika ditentukan, kolom ini akan mengambil halaman ulasan berikutnya.

orderBy

string

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

ignoreRatingOnlyReviews

boolean

Apakah akan mengabaikan ulasan rating saja.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk Reviews.BatchGetreviews.

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 berikutnya. 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 informasi selengkapnya, lihat Ringkasan OAuth 2.0.

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.