GoogleLocations API를 사용하면 이전에 비즈니스 프로필에서 위치의 소유권 주장이 제기되었는지 미리 확인할 수 있습니다. 이렇게 하면 위치 소유권 주장이 제기된 경우 즉시 위치 액세스를 요청할 수 있습니다. 또한 일괄 인증된 계정을 관리하는 경우 잠재적인 일치 항목을 사전에 더 정확하게 선택하고 중복 위치를 만들지 않을 수 있습니다.
API 엔드포인트는 위치의 소유권을 이미 주장했는지 여부를 나타내는 URL을 반환합니다. 소유권 주장이 제기된 경우 동일한 URL을 사용하여 액세스 요청 절차를 시작할 수 있습니다.
다음 이미지는 위치의 소유권을 얻는 과정의 개요를 제공합니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/locations1.png?authuser=5&hl=ko)
다음 단계에 따라 GoogleLocations
API를 사용할 수 있습니다.
- 판매자로부터 위치 데이터를 수집합니다.
-
googleLocations.search
엔드포인트를 호출합니다. 호출 본문 내에 위치 데이터를 제공합니다. 또는 사용자가 검색이나 지도에 입력한 내용과 비슷한 쿼리 문자열로 제공할 수도 있습니다. 예: '종로 5가 스타벅스'API에서
locationName
및 주소와 같이 잠재적으로 일치하는 위치 목록과 각 위치의 정보를 반환합니다. - 내 위치와 일치하는 위치를 선택합니다. 일치하는 항목이 없으면
accounts.locations.create
를 호출하고 5단계로 건너뜁니다. -
응답의
requestAdminRightsUrl
상태에 따라 다음 작업을 실행합니다.requestAdminRightsUrl
코드가 있으면 다른 사용자가 등록정보의 소유권을 가집니다. 비즈니스 프로필의 기존 위치 액세스 및 소유권 요청을 시작할 수 있는 URL로 판매자를 안내합니다.requestAdminRightsUrl
코드가 없으면accounts.locations.create
코드를 호출하고 나중에 인증할 새 비즈니스 정보를 만듭니다.
- 이 과정에서 새 비즈니스 정보를 만든 경우 인증 API를 사용하여 비즈니스 정보 인증을 시작할 수 있습니다. 자세한 내용은 인증 관리를 참고하세요.