Method: customers.getIdentityVerification

Restituisce informazioni sulla verifica dell'identità.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

GET https://googleads.googleapis.com/v16/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 per la 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 pagina Panoramica di OAuth 2.0.

IdentityVerification

Una 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 sull'avanzamento del programma di verifica per questo cliente.

IdentityVerificationRequirement

Informazioni sui requisiti di verifica per un tipo di programma di verifica.

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

string

Il termine ultimo per avviare la verifica nel formato "aaaa-MM-gg HH:mm:ss".
verificationCompletionDeadlineTime

string

Il termine ultimo per inviare la verifica.

IdentityVerificationProgress

Informazioni sull'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, ERRORE ecc.)
actionUrl

string

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

IdentityVerificationProgramStatus

Stato del programma della 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 eseguita correttamente.
FAILURE Verifica non riuscita.