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.listRecommendGoogleLocations
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menampilkan daftar semua GoogleLocation yang telah direkomendasikan ke akun Profil Bisnis yang ditentukan. Rekomendasi hanya diberikan untuk akun pribadi dan grup lokasi. Permintaan untuk semua jenis akun lainnya akan mengakibatkan error. Rekomendasi untuk grup lokasi didasarkan pada lokasi di grup tersebut.
Rekomendasi untuk akun pribadi didasarkan pada semua lokasi yang dapat diakses pengguna di Profil Bisnis (yang mencakup lokasi yang dapat mereka akses melalui grup lokasi), dan merupakan superset dari semua rekomendasi yang dibuat untuk pengguna.
Permintaan HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
name |
string
Nama resource akun untuk mengambil lokasi Google yang direkomendasikan.
|
Parameter kueri
| Parameter |
pageSize |
integer
Berapa banyak lokasi yang akan diambil per halaman. Ukuran halaman default adalah 25, minimum 1, dan maksimum 100.
|
pageToken |
string
Jika ditentukan, halaman lokasi berikutnya akan diambil.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Pesan respons untuk GoogleLocations.ListRecommendedGoogleLocations.
Laporan ini juga berisi beberapa lokasi yang telah diklaim oleh pengguna Profil Bisnis lain sejak terakhir kali lokasi tersebut direkomendasikan ke akun Profil Bisnis ini.
| Representasi JSON |
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| Kolom |
googleLocations[] |
object (GoogleLocation)
Lokasi yang direkomendasikan ke akun Profil Bisnis. Masing-masing mewakili GoogleLocation yang ada di Maps. Lokasi diurutkan secara menurun sesuai urutan relevansi dengan akun Profil Bisnis.
|
totalSize |
integer
Total jumlah lokasi yang direkomendasikan untuk akun Profil Bisnis ini, terlepas dari penomoran halaman.
|
nextPageToken |
string
Selama penomoran halaman, jika ada lebih banyak lokasi yang tersedia untuk diambil di halaman berikutnya, kolom ini akan diisi dengan token untuk mengambil halaman lokasi berikutnya dalam panggilan berikutnya. Jika tidak ada lagi lokasi yang akan diambil, 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-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eLists recommended Google Locations for a specified Business Profile account, suitable for personal accounts and location groups.\u003c/p\u003e\n"],["\u003cp\u003eRecommendations are based on locations the user has access to and are sorted by relevance.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes location details, total recommendations, and pagination token for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Business Profile management.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listRecommendGoogleLocations\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.ListRecommendedGoogleLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nList all the [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)s that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and location groups only, requests for all other account types will result in an error. The recommendations for location groups are based on the locations in that group.\n\nThe recommendations for personal accounts are based on all of the locations that the user has access to on Business Profile (which includes locations they can access through location groups), and is a superset of all recommendations generated for the user.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------|\n| `name` | `string` Name of the account resource to fetch recommended Google locations for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many locations to fetch per page. Default is 25, minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, the next page of locations is retrieved. |\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 GoogleLocations.ListRecommendedGoogleLocations.\n\nIt also contains some locations that have been claimed by other Business Profile users since the last time they were recommended to this Business Profile account.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"googleLocations\": [ { object (/my-business/reference/rest/v4/googleLocations#GoogleLocation) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleLocations[]` | `object (`[GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)`)` The locations recommended to a Business Profile account. Each of these represents a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation) that is present on Maps. The locations are sorted in decreasing order of relevance to the Business Profile account. |\n| `totalSize` | `integer` The total number of recommended locations for this Business Profile account, irrespective of pagination. |\n| `nextPageToken` | `string` During pagination, if there are more locations available to be fetched in the next page, this field is populated with a token to fetch the next page of locations in a subsequent call. If there are no more locations to be fetched, 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)."]]
