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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
필드
method

enum (VerificationMethod)

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

languageCode

string

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

context

object (ServiceBusinessContext)

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

표시 데이터 외에 특정 결제 수단에 대한 사용자 입력 데이터입니다. 데이터가 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
emailAddress

string

선택사항입니다. EMAIL 메서드의 입력입니다. PIN을 전송할 이메일 주소입니다.

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

mailerContact

string

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

phoneNumber

string

선택사항입니다. PHONE_CALL/SMS 메서드의 입력입니다. 전화를 걸거나 SMS를 전송할 전화번호입니다. 사용 가능한 옵션에 있는 전화번호 중 하나여야 합니다.

token

object (VerificationToken)

선택사항입니다. 일부 파트너가 사용할 수 있는 VETTED_PARTNER 메서드의 입력입니다. 심사를 거친 계정에는 입력이 필요하지 않습니다. 위치와 연결된 토큰입니다. 위치와 연결된 토큰입니다.

trustedPartnerToken

string

TRUSTED_PARTNER 메서드의 입력입니다. 위치와 연결된 인증 토큰입니다.

상호 배타적 필드의 끝입니다.

응답 본문

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

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

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

object (Verification)

생성된 인증 요청입니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

VerificationToken

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

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

string

토큰 문자열입니다.