인증 관리

자사의 플랫폼에서 직접 등록정보 관리 기능을 제공하는 업체는 자체 사이트 내에서 판매자의 비즈니스를 인증할 수 있습니다. 따라서 판매자를 비즈니스 프로필 UI로 리디렉션할 필요가 없습니다.

현재 상태 가져오기

사용자는 위치에 대해 locations.getVoiceOfMerchantState를 호출하여 해당 위치의 현재 상태를 가져올 수 있습니다. hasVoiceOfMerchant 불리언이 true면 위치가 이미 양호한 상태이므로 추가 조치가 필요하지 않습니다. 그렇지 않고 응답의 gain_voice_of_merchant 작업에 verify가 포함된 경우에는 인증을 완료해야 합니다. 자세한 내용을 보려면 다음 안내를 따르세요.

인증 옵션 가져오기

제공업체는 locations.fetchVerificationOptions 메서드를 사용하여 판매자에게 사용 가능한 인증 방법 목록에서 원하는 연락 방법을 선택하도록 요청할 수 있습니다.

인증 옵션을 가져오려면 다음 코드를 사용하세요.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

인증 절차 시작하기

인증 방법을 선택한 후 locations.verify로 인증 절차를 시작합니다. 이 호출의 결과로, 위치가 인증된 상태로 이동하거나 오류 상태가 반환됩니다.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

현재 인증 가져오기

locations.verifications.list 호출은 호출에 지정된 위치의 상태와 함께 인증 요청 내역을 가져옵니다.

모든 인증 요청을 가져오려면 다음을 사용하세요.

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

대기 중인 인증 완료하기

비즈니스의 인증을 완료하려면 일반적으로 PIN 코드와 locations.verifications.complete 메서드가 필요합니다.

대기 중인 인증을 완료하려면 다음 코드를 사용하세요.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

API를 사용한 Google 비즈니스 프로필 인증 권장사항

위치 생성

GBP Business Information API를 사용하면 플랫폼을 삽입하여 위치 생성 기능을 제공할 수 있습니다. 판매자에게 새 위치를 추가해 달라고 요청할 때 다음 단계를 따르세요.

판매자로부터 비즈니스 이름, 주소, 카테고리 등의 위치 정보를 수집합니다.

  1. googleLocations.search 엔드포인트를 호출합니다.
  2. API 요청에 비즈니스 이름, 카테고리, 주소, 전화번호, 웹사이트 등의 위치 데이터를 입력합니다.

또는 아래 단계에 따라 일치할 만한 위치를 검색해 봅니다.

  1. 일치 가능성이 있는 위치를 쿼리합니다.
  2. 판매자에게 올바른 위치를 선택해 달라고 요청합니다.
  3. 위치 응답에 requestAdminRightsUrl이 있으면 판매자가 Google 비즈니스 프로필에서 이 위치에 대한 액세스 및 소유권을 요청할 수 있도록 지원합니다.
  4. requestAdminRightsUrl이 없으면 위치 응답의 장소 ID를 이용해 새 위치를 만듭니다.
  5. 새 위치를 인증합니다.

참고: 초기 쿼리에서 일치 가능성이 있는 위치가 표시되지 않으면 빈 장소 ID를 이용해 새 위치를 만드세요. 그런 다음 새 위치를 인증하세요.

위치 인증

GBP API를 이용해 인증 절차를 시작하려면 다음 단계를 따르세요.

  1. accounts.locations.list 메서드를 호출하여 Google 계정의 모든 위치를 표시합니다.
  2. 인증할 위치를 선택합니다.
  3. GetVoiceOfMerchant API 메서드를 호출하여 인증이 필요한 위치인지 확인합니다.
  4. 응답에서 verify를 반환하면 fetchVerificationOptions를 호출하여 위치 인증에 사용할 수 있는 메서드 목록을 가져옵니다.
  5. verificationOption 데이터에 주소, 전화번호, 이메일 주소가 정확하게 반영되었는지 다시 한번 확인합니다.
  6. 판매자가 사용 가능한 인증 옵션 중 가장 적합한 옵션을 선택하면 locations.verify 메서드를 호출하여 적절한 인증을 시작합니다. 인증이 진행되고 있는지 확인하려면 locations.verifications.list.를 호출합니다.
  7. 판매자의 PIN을 이용해 locations.verification.complete 메서드를 호출합니다.
  8. GetVoiceOfMerchant API 메서드를 호출합니다. HasVoiceOfMerchant = true이면 위치가 정상적으로 인증된 것입니다.

참고: AUTO 인증을 사용할 수 있는 위치이면 판매자가 인증 단계를 수행하지 않아도 됩니다.

GBP 인증에 대해 자세히 알아보려면 고객센터 지원 도움말을 참고하세요.

심사를 마친 파트너의 인증 방법 가이드