Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
Method: googleLocations.search
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 요청과 일치하는 가능한 모든 위치를 검색합니다.
HTTP 요청
POST https://mybusiness.googleapis.com/v4/googleLocations:search
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"resultCount": integer,
// Union field search_query can be only one of the following:
"location": {
object (Location )
},
"query": string
// End of list of possible types for union field search_query .
} |
필드 |
resultCount |
integer
반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청되면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기는 없습니다.
|
통합 필드 search_query . 검색어 위치 객체 또는 문자열 쿼리로 제공될 수 있습니다. search_query 은 다음 중 하나여야 합니다. |
location |
object (Location )
검색할 위치입니다. 제공되는 경우 는 제공된 위치 세부정보와 일치하는 위치를 찾습니다.
|
query |
string
검색할 텍스트 쿼리입니다. 검색어 문자열의 검색 결과는 정확한 위치를 제공하는 경우보다 정확도가 떨어질 수 있지만 부정확한 일치 결과는 더 많이 제공할 수 있습니다.
|
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
GoogleLocations.SearchGoogleLocations의 응답 메시지입니다.
필드 |
googleLocations[] |
object (GoogleLocation )
지정된 요청과 일치할 가능성이 있는 GoogleLocations 컬렉션으로, 정확성이 가장 높은 것부터 순서대로 나열됩니다.
|
승인 범위
다음 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-07-25(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eSearch for Google Locations using either a specific location or a text-based query.\u003c/p\u003e\n"],["\u003cp\u003eSpecify the desired number of search results, with a maximum of 10.\u003c/p\u003e\n"],["\u003cp\u003eResults are returned in order of accuracy, with the most accurate matches appearing first.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"]]],["The core content describes searching for Google locations via a `POST` request to `https://mybusiness.googleapis.com/v4/googleLocations:search`. The request body can include either a `location` object or a string `query` within the `search_query` field, plus an integer `resultCount`. The response body contains an array of `googleLocations`, representing potential matches ranked by accuracy. Authorization requires either `plus.business.manage` or `business.manage` OAuth scopes.\n"],null,[]]