위치의 인증 절차를 시작합니다.
HTTP 요청
POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
name |
필수 항목입니다. 인증할 위치의 리소스 이름입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| JSON 표현 |
|---|
{ "method": enum ( |
| 필드 | |
|---|---|
method |
필수 항목입니다. 확인 방법입니다. |
languageCode |
선택사항입니다. 인증 절차에 사용할 언어를 나타내는 BCP 47 언어 코드입니다. |
context |
선택사항입니다. 서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에만 필요합니다. 주소 인증의 경우 엽서를 발송하는 데 주소가 사용됩니다. 다른 메서드의 경우 GetVerificationOptions에 전달된 것과 동일해야 합니다. 다른 유형의 비즈니스 위치에 설정하면 INVALID_ARGUMENT가 발생합니다. |
| 표시 데이터 외에 특정 결제 수단에 대한 사용자 입력 데이터입니다. 데이터가 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
emailAddress |
선택사항입니다. EMAIL 메서드의 입력입니다. PIN을 전송할 이메일 주소입니다. 이메일 주소는 locations.fetchVerificationOptions에서 제공하는 주소 중 하나인 경우에만 허용됩니다. [EmailVerificationData][google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] 에 isUserNameEditable이 true로 설정된 경우 클라이언트는 다른 사용자 이름(로컬 부분)을 지정할 수 있지만 도메인 이름과 일치해야 합니다. |
mailerContact |
선택사항입니다. ADDRESS 메서드의 입력입니다. 메일을 보낼 연락처 이름입니다. |
phoneNumber |
선택사항입니다. PHONE_CALL/SMS 메서드의 입력입니다. 전화를 걸거나 SMS를 전송할 전화번호입니다. 사용 가능한 옵션에 있는 전화번호 중 하나여야 합니다. |
token |
선택사항입니다. 일부 파트너가 사용할 수 있는 VETTED_PARTNER 메서드의 입력입니다. 심사를 거친 계정에는 입력이 필요하지 않습니다. 위치와 연결된 토큰입니다. 위치와 연결된 토큰입니다. |
trustedPartnerToken |
TRUSTED_PARTNER 메서드의 입력입니다. 위치와 연결된 인증 토큰입니다. |
| 상호 배타적 필드의 끝입니다. | |
응답 본문
Verifications.VerifyLocation의 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
| JSON 표현 |
|---|
{
"verification": {
object ( |
| 필드 | |
|---|---|
verification |
생성된 인증 요청입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/business.manage
자세한 내용은 OAuth 2.0 Overview를 참조하세요.
VerificationToken
검증된 파트너가 생성한 토큰입니다.
| JSON 표현 |
|---|
{ "tokenString": string } |
| 필드 | |
|---|---|
tokenString |
토큰 문자열입니다. |