Method: customers.getIdentityVerification

Gibt Informationen zur Identitätsbestätigung zurück.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
customerId

string

Erforderlich. Die ID des Kunden, für den wir Bestätigungsinformationen anfordern.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für [IdentityVerificationService.GetIdentityVerification].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
Felder
identityVerification[]

object (IdentityVerification)

Liste der Identitätsüberprüfungen für den Kunden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

IdentityVerification

Eine Identitätsüberprüfung für einen Kunden.

JSON-Darstellung 
{
  "verificationProgram": enum (IdentityVerificationProgram),
  "identityVerificationRequirement": {
    object (IdentityVerificationRequirement)
  },
  "verificationProgress": {
    object (IdentityVerificationProgress)
  }
}
Felder
verificationProgram

enum (IdentityVerificationProgram)

Die Art des Überprüfungsverfahrens.
identityVerificationRequirement

object (IdentityVerificationRequirement)

Die Bestätigungsanforderung für dieses Überprüfungsverfahren für diesen Kunden.
verificationProgress

object (IdentityVerificationProgress)

Informationen zum Fortschritt dieses Überprüfungsverfahrens für diesen Kunden.

IdentityVerificationRequirement

Informationen zu den Überprüfungsanforderungen für einen Überprüfungstyp.

JSON-Darstellung 
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
Felder
verificationStartDeadlineTime

string

Die Frist für den Start der Überprüfung im Format "JJJJ-MM-TT HH:mm:ss".
verificationCompletionDeadlineTime

string

Die Frist zum Einreichen der Bestätigung.

IdentityVerificationProgress

Informationen zum Fortschritt der Überprüfung für einen Überprüfungstyp.

JSON-Darstellung 
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
Felder
programStatus

enum (IdentityVerificationProgramStatus)

Aktueller Status (PENDING_USER_ACTION, SUCCESS, FAILURE usw.)
actionUrl

string

Aktions-URL, über die der Nutzer die Bestätigung für den angegebenen Bestätigungsprogrammtyp abschließen kann.

IdentityVerificationProgramStatus

Programmstatus der Identitätsbestätigung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
PENDING_USER_ACTION Die Bestätigung steht noch aus, wenn der Nutzer fortfahren soll.
PENDING_REVIEW Überprüfung steht aus.
SUCCESS Bestätigung erfolgreich.
FAILURE Bestätigung fehlgeschlagen.