Google Business Performance API memiliki metode API
BARU yang memungkinkan pengambilan beberapa `DailyMetrics` dalam satu permintaan API.
Tinjau
jadwal penghentian dan petunjuk untuk bermigrasi dari metode API reportInsights v4 ke Google Business Profile Performance API.
Method: accounts.locations.reviews.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menampilkan daftar ulasan bernomor halaman untuk lokasi yang ditentukan. Operasi ini hanya valid jika lokasi yang ditentukan diverifikasi.
Permintaan HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
parent |
string
Nama lokasi untuk mengambil ulasan.
|
Parameter kueri
| Parameter |
pageSize |
integer
Berapa banyak ulasan yang harus diambil per halaman. pageSize maksimum adalah 50.
|
pageToken |
string
Jika ditentukan, kolom ini akan mengambil halaman ulasan berikutnya.
|
orderBy |
string
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.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Pesan respons untuk Reviews.List Reviews.
| Representasi JSON |
{
"reviews": [
{
object (Review)
}
],
"averageRating": number,
"totalReviewCount": integer,
"nextPageToken": string
} |
| Kolom |
reviews[] |
object (Review)
Ulasan.
|
averageRating |
number
Rating bintang rata-rata dari semua ulasan untuk lokasi ini dalam skala 1 hingga 5, dengan 5 adalah rating tertinggi.
|
totalReviewCount |
integer
Total jumlah ulasan untuk lokasi ini.
|
nextPageToken |
string
Jika jumlah ulasan melampaui ukuran halaman yang diminta, kolom ini diisi dengan token untuk mengambil halaman ulasan berikutnya pada panggilan selanjutnya ke reviews.list. Jika tidak ada lagi ulasan, kolom ini tidak ada dalam respons.
|
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eRetrieves a paginated list of reviews for a specified, verified Google My Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by page size, page token, and sorting order (rating, rating descending, or update time descending).\u003c/p\u003e\n"],["\u003cp\u003eReturns review details, average rating, total review count, and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for business management.\u003c/p\u003e\n"]]],["This content outlines the process of retrieving a paginated list of reviews for a verified location using a `GET` request to a specific URL. The URL utilizes path parameters like `parent` to identify the location. Query parameters such as `pageSize`, `pageToken`, and `orderBy` are used to manage pagination and sorting. The request body is empty. A successful response returns a JSON object containing a list of `reviews`, `averageRating`, `totalReviewCount`, and optionally `nextPageToken` for pagination. Authorization requires specific OAuth scopes.\n"],null,["# Method: accounts.locations.reviews.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListReviewsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns the paginated list of reviews for the specified location. This operation is only valid if the specified location is verified.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------|\n| `parent` | `string` The name of the location to fetch reviews for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many reviews to fetch per page. The maximum `pageSize` is 50. |\n| `pageToken` | `string` If specified, it fetches the next page of reviews. |\n| `orderBy` | `string` Specifies the field to sort reviews by. If unspecified, the order of reviews returned will default to `updateTime desc`. Valid orders to sort by are `rating`, `rating desc` and `updateTime desc`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for Reviews.ListReviews.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"reviews\": [ { object (/my-business/reference/rest/v4/accounts.locations.reviews#Review) } ], \"averageRating\": number, \"totalReviewCount\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `reviews[]` | `object (`[Review](/my-business/reference/rest/v4/accounts.locations.reviews#Review)`)` The reviews. |\n| `averageRating` | `number` The average star rating of all reviews for this location on a scale of 1 to 5, where 5 is the highest rating. |\n| `totalReviewCount` | `integer` The total number of reviews for this location. |\n| `nextPageToken` | `string` If the number of reviews exceeded the requested page size, this field is populated with a token to fetch the next page of reviews on a subsequent call to reviews.list. If there are no more reviews, this field is not present in the response. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
