Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는 새로운 API 메서드가 있습니다. v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면 지원 중단 일정 및 안내를 검토하세요.
Business Profile API를 사용하면 Google에 표시되는 비즈니스를 판매자가 관리하는 플랫폼을 만들 수 있습니다. 플랫폼에서 파트너가 비즈니스 이름, 주소, 전화 데이터와 일치하는 비즈니스 정보를 검색하도록 허용할 수 있습니다. 파트너는 위치의 소유권을 설정할 수 있으며, 비즈니스의 실제 위치를
위도와 경도 기준으로 정확하게 배치할 수 있습니다.
시작하기 전에
Business Profile API를 사용하기 전에 애플리케이션을 등록하고 OAuth 2.0 사용자 인증 정보를 획득해야 합니다. Business Profile API를 시작하는 방법에 관한 자세한 내용은 기본 설정을 참고하세요.
주소 데이터 사용 방법
플랫폼에서 주소 및 위치정보 데이터를 사용하기 위해 Business Profile API와 지도 API라는 두 가지 서로 다른 API와 리소스를 사용할 수 있습니다.
일반적으로 사용되는 비즈니스 프로필 리소스
판매자는 GoogleLocations API를 사용하여 비즈니스 프로필에서 위치의 소유권 주장이 이미 제기되었는지 미리 확인할 수 있습니다. 소유권 주장이 제기되지 않았다면 판매자가 즉시 이 위치에 대한 액세스를 요청할 수 있습니다.
지오코딩을 사용하여 주소의 지오코딩과 역 지오코딩을
제공합니다. 가격 책정에 관한 자세한 내용은
SKU: 지오코딩을 참고하세요.
1개 또는 0개 일치
파트너가 위치와 일치하는 비즈니스 정보를 검색하는 경우 검색 결과를 1개 또는 0개로 좁히는 것이 목표입니다. 이는 각각 위치가 검색 기준에 부합하거나 비즈니스 프로필에 아직 존재하지 않음을 의미합니다.
일치 항목이 1개 또는 0개인 경우 accounts.locations.create 메서드를 사용하여 새 비즈니스 정보를 생성하거나 GoogleLocations 가이드에 따라 기존 비즈니스 정보의 소유권을 주장하세요. Google에서 주소를 지오코딩할 수 없는
경우 위치 생성에 실패하고 API 응답에 LatLng 데이터 요청이
포함됩니다. 판매자가 LatLng 데이터를 제공하는 방법에
관한 자세한 내용은
위치정보 데이터 수동 조정을 참고하세요.
LatLng 좌표가 확인되면 새 비즈니스 정보가 생성됩니다.
부분 일치 및 다중 일치
비즈니스 소유자 또는 파트너의 운영팀이 위치와 일치하는 비즈니스 정보를 검색할 때,
입력하는 정보와 부분적으로만 일치하는 결과가 반환되거나 검색어와 일치하는 결과가
여러 개일 수 있습니다. 검색 결과를
1개 또는 0개까지 좁히려면 두 개의 지도 API 사용 사례를 통해 부분 일치와 다중 일치를
수동으로 해결합니다.
사용자가 상세검색 실행
파트너 플랫폼의 사용자가 위치를 검색하고 부분 일치 결과가 여러 건 표시된 경우
다음 방법 중 하나로 문제를 해결할 수
있습니다.
부분 일치 주소를 분석하고 올바른 주소를 선택합니다.
정확성을 높일 수 있도록 주소의 일부를 수정하거나 다시 입력하여 검색 결과를
1개 또는 0개로 좁힙니다.
주소 검색의 응답으로 여러 건의 부분 일치 항목이 사용자에게 표시됩니다.
사용자가 하나 이상의 전체 일치 항목 중에서 선택
경우에 따라 여러 위치가 사용자의 검색 주소와 완전히 일치할 수 있습니다.
사용자가 파트너 플랫폼에 다음 주소를 입력하는 경우를 예로 들 수 있습니다.
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
다음 응답이 반환되었으며, 검색한 주소와 모두 일치한다고 가정해
보겠습니다.
Kasperson Printer Center, 인증되지 않은 위치
Bengo Seguro, 인증된 위치
Garush Productions, 인증되지 않은 위치
사용자는 일치하는 비즈니스를 수동으로 선택해야 합니다. 소비자에게 비즈니스에 관한
정확한 경로를 제공하기 위해 이러한 위치의 위도 및
경도(LatLng) 데이터를 조정하여 정확도를 높일 필요가 있을 수
있습니다. 사용자가 직접 LatLng를 입력하는 방법에 관한 자세한 내용은
위치정보 데이터 수동 조정을 참고하세요.
위치정보 데이터 수동 조정
비즈니스는 위도 및 경도(LatLng) 좌표를 추가하여 비즈니스 프로필의 비즈니스 정보 정확도를 높일 수 있습니다. 신규 비즈니스에서 LatLng 좌표를 모르는 경우 지도 JavaScript Place Widgets으로 장소를 직접 핀으로 고정하여 정확한 LatLng 좌표를 설정할 수 있습니다.
1개의 주소가 1,500피트 거리의 위치 3곳으로 확인됩니다. 비즈니스
주소를 LatLng 좌표와 정확하게 연결하려면
각 위치의 좌표를 수동으로 조정해야
합니다.
검색 결과의 품질
검색 결과는 검색한 주소의 정확성과 지역에 따라
크게 달라집니다. 개발 중인 지역의 경우 Google 지도에 표시되는 장소가 많지 않고
Google 주소 형식을 따르지 않은 장소가 표시되기도 합니다. 이 경우
검색 결과의 품질이 낮아지므로 주소 형식을 수동으로 지정하고 지도 API를 사용할 필요성이
커집니다.
[[["이해하기 쉬움","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-08-29(UTC)"],[[["\u003cp\u003eThe Business Profile APIs allow you to build platforms for merchants to manage their Google Business Profiles, including claiming locations and providing accurate address data.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the APIs, you need to register your application and obtain OAuth 2.0 credentials.\u003c/p\u003e\n"],["\u003cp\u003eAddress and geolocation data can be managed using both Business Profile APIs and Google Maps APIs to refine location accuracy.\u003c/p\u003e\n"],["\u003cp\u003eWhen search results yield multiple or partial matches, manual refinement or selection might be necessary to ensure accuracy.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can manually adjust geolocation data using latitude and longitude coordinates to improve listing precision.\u003c/p\u003e\n"]]],[],null,["# Search for matching listings\n\n\u003cbr /\u003e\n\nWith the Business Profile APIs, you can create a platform for your merchants to\nmanage their business on Google. On your platform, you can allow your partners\nto search for listings that match their business's name, address, and phone\ndata. They can establish ownership of a location, as well as accurately place\nthe business's physical location by latitude and longitude.\n\nBefore you begin\n----------------\n\nBefore you use the Business Profile APIs, you need to register your application\nand obtain OAuth 2.0 credentials. For details on how to get started with the\nBusiness Profile APIs, see [Basic setup](/my-business/content/basic-setup).\n\nHow to work with address data\n-----------------------------\n\nTo work with address and geolocation data on your platform, you may use two\ndifferent sets of APIs and resources: the Business Profile APIs and the Maps\nAPI.\n\n### Commonly used Business Profile resources\n\nThe [`GoogleLocations`](/my-business/content/googlelocations-api-guide) API lets\nthe merchant see in advance if a location has already been claimed in\nBusiness Profile. If not, it allows the merchant to immediately request\naccess to it.\n\nThe [`PostalAddress`](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.PostalAddress) object\nrepresents the physical address of a business.\n\n### Commonly used Google Maps resources\n\nThe [Maps JavaScript Places Widgets](/maps/documentation/javascript/reference/places-widget)\nare commonly used in partner workflows to create an interactive map. In\naddition, the following Maps APIs are also useful:\n\n- Return place predictions with [Place Autocomplete](/places/web-service/autocomplete) and [Place Details](/places/web-service/details). For pricing details, see [SKU: Autocomplete (included with Places Details) -- Per Session](/maps/billing/understanding-cost-of-use?__utma=236542612.573697022.1545861194.1545861265.1545861265.1&__utmb=236542612.0.10.1545861265&__utmc=236542612&__utmx=-&__utmz=236542612.1545861265.1.1.utmcsr=(direct)%7Cutmccn=(direct)%7Cutmcmd=(none)&__utmv=-&__utmk=91275353&_ga=2.77608016.-573697022.1545861194#ac-with-details-session).\n- Query for place information with [Place Search](/places/web-service/search). For pricing details, see [SKU: Find Place](/maps/billing/understanding-cost-of-use?__utma=236542612.573697022.1545861194.1545861265.1545861265.1&__utmb=236542612.0.10.1545861265&__utmc=236542612&__utmx=-&__utmz=236542612.1545861265.1.1.utmcsr=(direct)%7Cutmccn=(direct)%7Cutmcmd=(none)&__utmv=-&__utmk=91275353&_ga=2.77608016.-573697022.1545861194#find-place).\n- Provide geocoding and reverse geocoding of addresses with [Geocoding](/maps/documentation/geocoding/start). For pricing details, see [SKU: Geocoding](/maps/billing/understanding-cost-of-use?__utma=236542612.573697022.1545861194.1545861265.1545861265.1&__utmb=236542612.0.10.1545861265&__utmc=236542612&__utmx=-&__utmz=236542612.1545861265.1.1.utmcsr=(direct)%7Cutmccn=(direct)%7Cutmcmd=(none)&__utmv=-&__utmk=91275353&_ga=2.77608016.-573697022.1545861194#geocoding).\n\nOne or zero matches\n-------------------\n\nWhen a partner searches for matching listings for a location, their goal is to\nnarrow their search results to one or zero matches. This means the location\neither fits their search criteria or doesn't yet exist in Business Profile,\nrespectively.\n\nWhere there are one or zero matches, use the\n[`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create)\nmethod to create a new listing, or follow the\n[`GoogleLocations`](/my-business/content/googlelocations-api-guide) guide to\nclaim ownership of the existing listing. If Google is unable to geocode the\naddress, the location creation fails and the API response includes a request for\n`LatLng` data. For information on how the merchant can provide their `LatLng`\ndata, see\n[Manual adjustment of geolocation data](/my-business/content/search-matching-listings#adjustment-geolocation-data).\n\nOnce the `LatLng` coordinates are determined, the new listing is created.\n\nPartial and multiple matches\n----------------------------\n\nWhen a business owner or the partner's operations team searches for listings\nthat match a location, the information they type might result in only a partial\nmatch, or they might receive multiple matches to their search query. To narrow\nthe search results down to one or zero matches, partial and multiple matches are\nmanually resolved by two Maps API use cases.\n\n### User refines their search\n\nWhen a user of the partner platform searches for a location and is faced with\nmultiple partial matches, they can resolve the issue in one of the following\nways:\n\n- Analyze the partial matching addresses and select the correct one.\n- Edit or retype parts of the address to be more accurate and narrow their results to one or zero matches.\n\nA user is confronted with several partial matches in response to their address search.\n\n### User selects from one or more full matches\n\nIn some cases, multiple locations might fully match the user's search address.\nFor instance, a user might enter the following address into a partner platform:\n\n`Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia`\n\nSuppose the following responses are returned, all of which match the address\ngiven:\n\n- Kasperson Printer Center, an unverified location.\n- Bengo Seguro, a verified location.\n- Garush Productions, an unverified location.\n\nThe user needs to manually select the matching business. To ensure consumers are\nprovided with accurate directions to the business, the latitude and longitude\n(`LatLng`) data for these locations might need to be adjusted to provide higher\naccuracy. For information on how users can enter their `LatLng` manually, see\n[Manual adjustment of geolocation data](/my-business/content/search-matching-listings#adjustment-geolocation-data).\n\nManual adjustment of geolocation data\n-------------------------------------\n\nBusinesses can add the latitude and longitude (`LatLng`) coordinates of their\nbusiness to increase the accuracy of their listing on Business Profile. New\nbusinesses might not know their `LatLng` coordinates, so they can instead\nmanually drop a pin with the\n[Maps JavaScript Places Widget](/maps/documentation/javascript/reference/places-widget)\nto establish accurate `LatLng` coordinates.\nA single address resolves to three locations 1,500 feet apart. To accurately associate the business address with its `LatLng` coordinates, manual adjustment of each location's coordinates is needed.\n\nQuality of search results\n-------------------------\n\nSearch results vary widely based on the accuracy of the address that is searched\nfor and by geographic region. Developing regions often show fewer Maps places\nand inconsistent compliance with Google address formats. This leads to\nlower-quality search results and an increased need for manual address formatting\nand Maps API use."]]
