Method: accounts.listRecommendGoogleLocations
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Liệt kê tất cả GoogleLocation đã được đề xuất cho tài khoản Trang doanh nghiệp được chỉ định. Thông tin đề xuất chỉ được cung cấp cho các tài khoản cá nhân và nhóm vị trí. Yêu cầu cho tất cả các loại tài khoản khác sẽ dẫn đến lỗi. Các đề xuất cho nhóm vị trí được dựa trên những vị trí trong nhóm đó.
Các đề xuất cho tài khoản cá nhân được dựa trên tất cả các vị trí mà người dùng có quyền truy cập trên Trang doanh nghiệp (bao gồm cả những vị trí mà họ có thể truy cập thông qua các nhóm vị trí) và là tập hợp tất cả các đề xuất được tạo cho người dùng.
Yêu cầu HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
name |
string
Tên của tài nguyên tài khoản để tìm nạp các vị trí được đề xuất trên Google.
|
Tham số truy vấn
| Tham số |
pageSize |
integer
Số lượng vị trí cần tìm nạp trên mỗi trang. Giá trị mặc định là 25, tối thiểu là 1 và kích thước trang tối đa là 100.
|
pageToken |
string
Nếu được chỉ định, trang tiếp theo của vị trí sẽ được truy xuất.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Thông báo phản hồi cho GoogleLocations.ListRecommendedGoogleLocations.
Trang doanh nghiệp này cũng chứa một số vị trí đã được những người dùng Trang doanh nghiệp khác xác nhận quyền sở hữu kể từ lần gần đây nhất họ được đề xuất cho tài khoản Trang doanh nghiệp này.
| Biểu diễn dưới dạng JSON |
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| Trường |
googleLocations[] |
object (GoogleLocation)
Các vị trí được đề xuất cho tài khoản Trang doanh nghiệp. Mỗi đối tượng trong số này đại diện cho một GoogleLocation xuất hiện trên Maps. Các vị trí được sắp xếp theo thứ tự giảm dần mức độ liên quan đối với tài khoản Trang doanh nghiệp.
|
totalSize |
integer
Tổng số vị trí được đề xuất cho tài khoản Trang doanh nghiệp này, bất kể việc phân trang.
|
nextPageToken |
string
Trong quá trình phân trang, nếu có thêm vị trí có sẵn để tìm nạp trong trang tiếp theo, trường này được điền sẵn một mã thông báo để tìm nạp trang vị trí tiếp theo trong lệnh gọi tiếp theo. Nếu không còn vị trí nào khác cần được tìm nạp, thì trường này sẽ không xuất hiện trong phản hồi.
|
Phạm vi cấp phép
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
