Method: customers.getIdentityVerification

신원 확인 정보를 반환합니다.

발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 요청

GET https://googleads.googleapis.com/v16/customers/{customerId}/getIdentityVerification

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. Google에서 확인 정보를 요청하는 고객의 ID입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

[IdentityVerificationService.GetIdentityVerification]의 응답 메시지입니다.

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

JSON 표현 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
입력란
identityVerification[]

object (IdentityVerification)

고객 본인 확인 목록입니다.

승인 범위

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

  • https://www.googleapis.com/auth/adwords

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

IdentityVerification

고객 본인 인증

JSON 표현 
{
  "verificationProgram": enum (IdentityVerificationProgram),
  "identityVerificationRequirement": {
    object (IdentityVerificationRequirement)
  },
  "verificationProgress": {
    object (IdentityVerificationProgress)
  }
}
입력란
verificationProgram

enum (IdentityVerificationProgram)

인증 프로그램 유형입니다.
identityVerificationRequirement

object (IdentityVerificationRequirement)

해당 고객에 대한 이 확인 프로그램의 확인 요구사항입니다.
verificationProgress

object (IdentityVerificationProgress)

이 고객에 대한 이 확인 프로그램의 진행 상황에 관한 정보입니다.

IdentityVerificationRequirement

인증 프로그램 유형의 인증 요구사항 관련 정보입니다.

JSON 표현 
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
입력란
verificationStartDeadlineTime

string

확인을 시작해야 하는 기한은 'yyyy-MM-dd HH:mm:ss' 형식입니다.
verificationCompletionDeadlineTime

string

확인서를 제출해야 하는 기한입니다.

IdentityVerificationProgress

인증 프로그램 유형의 인증 진행 상황에 관한 정보입니다.

JSON 표현 
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
입력란
programStatus

enum (IdentityVerificationProgramStatus)

현재 상태 (PENDING_USER_ACTION, SUCCESS, FAILURE 등)
actionUrl

string

사용자가 지정된 인증 프로그램 유형에 대한 인증을 완료할 수 있는 작업 URL입니다.

IdentityVerificationProgramStatus

본인 인증의 프로그램 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
PENDING_USER_ACTION 계속 진행하기 위해 사용자 작업이 확인 대기 중입니다.
PENDING_REVIEW 인증이 검토 대기 중입니다.
SUCCESS 확인되었습니다.
FAILURE 확인할 수 없습니다.