Method: accounts.locations.verify

위치 인증 절차를 시작합니다.

HTTP 요청

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

확인할 위치의 리소스 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
필드
method

enum (VerificationMethod)

확인 방법입니다.
languageCode

string

인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다.
context

object (ServiceBusinessContext)

서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에 필수입니다. ADDRESS 인증의 경우 엽서를 발송할 때 주소가 사용됩니다. 다른 메서드의 경우 locations.fetchVerificationOptions에 전달되는 것과 동일해야 합니다. INVALID_ 이는 다른 유형의 업체 위치에 대해 설정된 경우 발생합니다.
통합 필드 RequestData. 표시 데이터 외에 특정 방식에 대한 사용자 입력 데이터입니다. 데이터가 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. RequestData은 다음 중 하나여야 합니다.
emailInput

object (EmailInput)

EMAIL 방법에 대한 입력입니다.
addressInput

object (AddressInput)

ADDRESS 메서드의 입력입니다.
phoneInput

object (PhoneInput)

PHONE_CALL/SMS 메서드에 대한 입력

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

Verifications.VerifyLocation의 응답 메시지입니다.

JSON 표현 
{
  "verification": {
    object (Verification)
  }
}
필드
verification

object (Verification)

생성된 인증 요청

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

EmailInput

이메일 확인을 위한 입력입니다.

JSON 표현 
{
  "emailAddress": string
}
필드
emailAddress

string

PIN을 받을 이메일 주소입니다.

이메일 주소는 locations.fetchVerificationOptions에서 제공한 주소 중 하나인 경우에만 허용됩니다. EmailVerificationData의 isUserNameEditable이 true로 설정되어 있으면 클라이언트는 다른 사용자 이름 (로컬 부분)을 지정할 수 있지만 도메인 이름과 일치해야 합니다.

AddressInput

ADDRESS 확인을 위한 입력입니다.

JSON 표현 
{
  "mailerContactName": string
}
필드
mailerContactName

string

메일을 받을 연락처 이름입니다.

PhoneInput

PHONE_CALL/SMS 인증을 위한 입력

JSON 표현 
{
  "phoneNumber": string
}
필드
phoneNumber

string

전화를 걸거나 SMS를 보낼 전화번호입니다. 지원되는 옵션에 있는 전화번호 중 하나여야 합니다.