Method: customers.getIdentityVerification

Restituisce le informazioni sulla verifica dell'identità.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente per il quale richiediamo le informazioni di verifica.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per [IdentityVerificationService.GetIdentityVerification].

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
Campi
identityVerification[]

object (IdentityVerification)

Elenco delle verifiche dell'identità per il cliente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

IdentityVerification

La verifica dell'identità di un cliente.

Rappresentazione JSON 
{
  "verificationProgram": enum (IdentityVerificationProgram),
  "identityVerificationRequirement": {
    object (IdentityVerificationRequirement)
  },
  "verificationProgress": {
    object (IdentityVerificationProgress)
  }
}
Campi
verificationProgram

enum (IdentityVerificationProgram)

Il tipo di programma di verifica.
identityVerificationRequirement

object (IdentityVerificationRequirement)

Il requisito di verifica di questo programma di verifica per questo cliente.
verificationProgress

object (IdentityVerificationProgress)

Informazioni sullo stato di avanzamento di questo programma di verifica per questo cliente.

IdentityVerificationRequirement

Informazioni relative ai requisiti di verifica per un tipo di programma di verifica.

Rappresentazione JSON 
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
Campi
verificationStartDeadlineTime

string

La scadenza per avviare la verifica nel formato "aaaa-MM-gg HH:mm:ss" formato.
verificationCompletionDeadlineTime

string

Il termine ultimo per inviare la verifica.

IdentityVerificationProgress

Informazioni relative all'avanzamento della verifica per un tipo di programma di verifica.

Rappresentazione JSON 
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
Campi
programStatus

enum (IdentityVerificationProgramStatus)

Stato attuale (PENDING_USER_ACTION, SUCCESS, FAILURE e così via)
actionUrl

string

URL dell'azione che consente all'utente di completare la verifica per il tipo di programma di verifica specificato.

IdentityVerificationProgramStatus

Stato del programma di verifica dell'identità.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
PENDING_USER_ACTION La verifica è in attesa dell'azione dell'utente per procedere.
PENDING_REVIEW La verifica è in attesa di revisione.
SUCCESS Verifica riuscita.
FAILURE Verifica non riuscita.