Method: locations.verify

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

HTTP 요청

POST https://mybusinessverifications.googleapis.com/v1/{name=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:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
필드
method

enum (VerificationMethod)

필수 항목입니다. 확인 방법입니다.

languageCode

string

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

context

object (ServiceBusinessContext)

선택사항입니다. 서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에만 필요합니다. ADDRESS 인증의 경우, 주소는 엽서를 발송하는 데 사용됩니다. 다른 메서드의 경우 GetVerificationOptions에 전달되는 것과 같아야 합니다. INVALID_ARGUMENT는 다른 유형의 업체 위치에 대해 설정된 경우 발생합니다.

통합 필드 RequestData. 표시 데이터 외에 특정 메서드의 사용자 입력 데이터입니다. 데이터는 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. RequestData은 다음 중 하나여야 합니다.
emailAddress

string

선택사항입니다. EMAIL 메서드에 대한 입력입니다. PIN을 수신할 이메일 주소입니다.

이메일 주소는 locations.fetchVerificationOptions에서 제공한 주소 중 하나인 경우에만 허용됩니다. [EmailVerificationData]의 [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] 의 isUserNameEditable이 true로 설정된 경우 클라이언트에서 다른 사용자 이름 (local-part)을 지정할 수 있지만 도메인 이름과 일치해야 합니다.

mailerContact

string

선택사항입니다. ADDRESS 메서드의 입력입니다. 메일을 받을 연락처 이름입니다.

phoneNumber

string

선택사항입니다. PHONE_CALL/SMS 메서드의 입력입니다. 전화를 걸거나 SMS를 받아야 할 전화번호입니다. 대상 옵션의 전화번호 중 하나여야 합니다.

token

object (VerificationToken)

선택사항입니다. 일부 파트너에 사용할 수 있는 VETTED_PARTNER 메서드에 대한 입력입니다. 심사된 계정에는 입력할 필요가 없습니다. 위치에 연결된 토큰입니다. 위치에 연결된 토큰입니다.

응답 본문

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

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

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

object (Verification)

생성된 인증 요청입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

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

VerificationToken

검증된 파트너가 생성한 토큰입니다.

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

string

토큰 문자열입니다.