Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
Method: accounts.listRecommendGoogleLocations
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 비즈니스 프로필 계정에 추천된 모든 GoogleLocation
를 나열합니다. 추천은 개인 계정 및 위치 그룹에만 제공되며, 다른 모든 계정 유형을 요청하면 오류가 발생합니다. 위치 그룹에 대한 추천은 해당 그룹에 있는 위치를 기반으로 합니다.
개인 계정을 위한 추천은 사용자가 비즈니스 프로필에서 액세스할 수 있는 모든 위치 (위치 그룹을 통해 액세스할 수 있는 위치 포함)를 기반으로 하며 사용자에게 생성된 모든 추천의 상위 집합입니다.
HTTP 요청
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
name |
string
추천 Google 위치를 가져올 계정 리소스의 이름입니다.
|
쿼리 매개변수
매개변수 |
pageSize |
integer
페이지당 가져올 위치 수입니다. 기본값은 25, 최소는 1, 최대 페이지 크기는 100입니다.
|
pageToken |
string
지정하면 위치의 다음 페이지가 검색됩니다.
|
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
GoogleLocations.ListRecommendedGoogleLocations에 대한 응답 메시지입니다.
또한 이 비즈니스 프로필 계정에 마지막으로 추천된 이후 다른 비즈니스 프로필 사용자가 소유권을 주장한 위치도 포함되어 있습니다.
JSON 표현 |
{
"googleLocations": [
{
object (GoogleLocation )
}
],
"totalSize": integer,
"nextPageToken": string
} |
필드 |
googleLocations[] |
object (GoogleLocation )
비즈니스 프로필 계정에 추천된 위치입니다. 각각은 지도에 있는 GoogleLocation 를 나타냅니다. 위치는 비즈니스 프로필 계정과의 관련성에 따라 내림차순으로 정렬됩니다.
|
totalSize |
integer
페이지로 나누기와 관계없이 이 비즈니스 프로필 계정의 총 추천 위치 수입니다.
|
nextPageToken |
string
페이지로 나누는 동안 다음 페이지에서 가져올 수 있는 위치가 더 있으면 이 필드는 후속 호출에서 다음 위치 페이지를 가져오는 토큰으로 채워집니다. 더 이상 가져올 위치가 없으면 이 필드는 응답에 표시되지 않습니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
자세한 내용은 OAuth 2.0 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 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)."]]