GoogleLocations

GoogleLocations API를 사용하면 이전에 비즈니스 프로필에서 위치의 소유권 주장이 제기되었는지 미리 확인할 수 있습니다. 이렇게 하면 위치 소유권 주장이 제기된 경우 즉시 위치 액세스를 요청할 수 있습니다. 또한 일괄 인증된 계정을 관리하는 경우 잠재적인 일치 항목을 사전에 더 정확하게 선택하고 중복 위치를 만들지 않을 수 있습니다.

API 엔드포인트는 위치의 소유권을 이미 주장했는지 여부를 나타내는 URL을 반환합니다. 소유권 주장이 제기된 경우 동일한 URL을 사용하여 액세스 요청 절차를 시작할 수 있습니다.

다음 이미지는 위치의 소유권을 얻는 과정의 개요를 제공합니다.

그림 1. 비즈니스 프로필 위치 소유권의 구획면 다이어그램

다음 단계에 따라 GoogleLocations API를 사용할 수 있습니다.

  1. 판매자로부터 위치 데이터를 수집합니다.

  2. googleLocations.search 엔드포인트를 호출합니다. 호출 본문 내에 위치 데이터를 제공합니다. 또는 사용자가 검색이나 지도에 입력한 내용과 비슷한 쿼리 문자열로 제공할 수도 있습니다. 예: '종로 5가 스타벅스'

    API에서 locationName 및 주소와 같이 잠재적으로 일치하는 위치 목록과 각 위치의 정보를 반환합니다.

  3. 내 위치와 일치하는 위치를 선택합니다. 일치하는 항목이 없으면 accounts.locations.create를 호출하고 5단계로 건너뜁니다.

  4. 응답의 requestAdminRightsUrl 상태에 따라 다음 작업을 실행합니다.

    1. requestAdminRightsUrl 코드가 있으면 다른 사용자가 등록정보의 소유권을 가집니다. 비즈니스 프로필의 기존 위치 액세스 및 소유권 요청을 시작할 수 있는 URL로 판매자를 안내합니다.
    2. requestAdminRightsUrl 코드가 없으면 accounts.locations.create 코드를 호출하고 나중에 인증할 새 비즈니스 정보를 만듭니다.
  5. 이 과정에서 새 비즈니스 정보를 만든 경우 인증 API를 사용하여 비즈니스 정보 인증을 시작할 수 있습니다. 자세한 내용은 인증 관리를 참고하세요.