Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는 새로운 API 메서드가 있습니다. v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면 지원 중단 일정 및 안내를 검토하세요.
GoogleLocations API를 사용하면 이전에 비즈니스 프로필에서 위치의 소유권 주장이 제기되었는지 미리 확인할 수 있습니다. 이렇게 하면 위치 소유권 주장이 제기된 경우 즉시 위치 액세스를 요청할 수 있습니다. 또한 일괄 인증된 계정을 관리하는 경우 잠재적인 일치 항목을
사전에 더 정확하게 선택하고 중복 위치를 만들지 않을 수 있습니다.
API 엔드포인트는 위치의 소유권을 이미 주장했는지 여부를 나타내는 URL을 반환합니다. 소유권 주장이 제기된 경우 동일한 URL을 사용하여 액세스 요청 절차를 시작할 수 있습니다.
다음 이미지는 위치의 소유권을 얻는 과정의 개요를 제공합니다.
그림 1. 비즈니스 프로필 위치 소유권의 구획면 다이어그램
다음 단계에 따라 GoogleLocations API를 사용할 수 있습니다.
판매자로부터 위치 데이터를 수집합니다.
googleLocations.search
엔드포인트를
호출합니다. 호출 본문 내에 위치 데이터를 제공합니다. 또는 사용자가 검색이나 지도에
입력한 내용과 비슷한 쿼리 문자열로 제공할 수도 있습니다. 예: '종로 5가 스타벅스'
API에서 locationName 및 주소와 같이 잠재적으로 일치하는 위치 목록과 각 위치의
정보를 반환합니다.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eThe GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed.\u003c/p\u003e\n"],["\u003cp\u003eIf a new listing is created, leverage verification APIs to complete the setup process.\u003c/p\u003e\n"],["\u003cp\u003eThis API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis.\u003c/p\u003e\n"]]],["The GoogleLocations API determines if a location is claimed in Business Profile. Using the `googleLocations.search` endpoint, provide location data to find matching locations. If a match exists, check `requestAdminRightsUrl`; if present, initiate an access request via the provided URL. If not, or if no match is found, create a new location with `accounts.locations.create`. New listings require verification through the verification APIs. This API is for merchants with business relationships, not lead generation.\n"],null,["# GoogleLocations\n\nThe GoogleLocations API allows you to see in advance whether a location has been\nclaimed in Business Profile. This way, if the location has been claimed, you can immediately\nrequest access to the location. Also, if you manage bulk-verified accounts, you can more accurately\nselect potential matches in advance and avoid the creation of duplicate locations.\n\nThe API endpoint returns a URL that indicates if a location has already been claimed. If it has\nbeen claimed, the same URL allows you to start the access request process.\n\nThe following image provides an overview of the process to gain ownership of a location.\n**Figure 1.** Swimlane diagram of Business Profile location ownership\n\nThe following steps allow you to use the `GoogleLocations` API:\n\n1. Collect location data from the merchant.\n2. Call the\n [`googleLocations.search`](/my-business/reference/businessinformation/rest/v1/googleLocations)\n endpoint. Provide the location data within the body of the call. Alternatively, you can provide\n it in a query string, similar to what a user would enter in Search or Maps. For example,\n \"Starbucks 5th ave NYC.\"\n\n The API returns a list of potentially matching locations and information about each location,\n such as `locationName` and address.\n3. Select the location that matches your location. If there are no matches, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create), and skip to step 5.\n4. Based on the state of `requestAdminRightsUrl` in the response, take the following\n actions:\n\n 1. If `requestAdminRightsUrl` exists, another user has ownership of the listing. Direct the merchant to the URL to start a request for access and ownership of the existing location in Business Profile.\n 2. If `requestAdminRightsUrl` doesn't exist, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create) and create a new listing that will be verified later.\n5. If you created new listings as part of this process, you can utilize the verification APIs to begin verification of the listings. For more information, see [Manage verification](/my-business/content/manage-verification).\n\n| **Note:** The GoogleLocations API is intended to find the status of locations for which your company has a business relationship with the merchant. The use of the endpoints for the purposes of lead generation or competitive analysis is against [Google's policies](/my-business/content/policies#prohibited_practices) and will result in revocation of API access."]]
