Method: customers.getIdentityVerification

Retorna informações de verificação de identidade.

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente para quem estamos solicitando informações de verificação.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para [IdentityVerificationService.GetIdentityVerification].

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
Campos
identityVerification[]

object (IdentityVerification)

Lista de verificações de identidade do cliente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

IdentityVerification

Uma verificação de identidade para um cliente.

Representação JSON 
{
  "verificationProgram": enum (IdentityVerificationProgram),
  "identityVerificationRequirement": {
    object (IdentityVerificationRequirement)
  },
  "verificationProgress": {
    object (IdentityVerificationProgress)
  }
}
Campos
verificationProgram

enum (IdentityVerificationProgram)

O tipo de programa de verificação.
identityVerificationRequirement

object (IdentityVerificationRequirement)

O requisito de verificação do programa de verificação para o cliente.
verificationProgress

object (IdentityVerificationProgress)

Informações sobre o progresso do programa de verificação do cliente.

IdentityVerificationRequirement

Informações sobre o requisito de verificação para um tipo de programa de verificação.

Representação JSON 
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
Campos
verificationStartDeadlineTime

string

O prazo para iniciar a verificação no formato "aaaa-MM-dd HH:mm:ss".
verificationCompletionDeadlineTime

string

O prazo para enviar a verificação.

IdentityVerificationProgress

Informações sobre o progresso da verificação para um tipo de programa de verificação.

Representação JSON 
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
Campos
programStatus

enum (IdentityVerificationProgramStatus)

Status atual (PENDING_USER_ACTION, SUCCESS, FAILED etc.)
actionUrl

string

URL de ação para o usuário concluir a verificação do tipo de programa de verificação especificado.

IdentityVerificationProgramStatus

Status do programa de verificação de identidade.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PENDING_USER_ACTION A ação do usuário está pendente para continuar.
PENDING_REVIEW A verificação está pendente.
SUCCESS Verificação concluída.
FAILURE Falha na verificação.