Method: customers.getIdentityVerification

Zwraca informacje dotyczące weryfikacji tożsamości.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, w imieniu którego prosimy o informacje weryfikacyjne.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na pytanie [Identity VerificationService.GetIdentity Verification].

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
Pola
identityVerification[]

object (IdentityVerification)

Lista weryfikacji tożsamości klienta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

IdentityVerification

Weryfikacja tożsamości klienta.

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

enum (IdentityVerificationProgram)

Typ programu weryfikacji.

identityVerificationRequirement

object (IdentityVerificationRequirement)

Wymagania weryfikacyjne obowiązujące tego klienta w ramach tego procesu weryfikacji.

verificationProgress

object (IdentityVerificationProgress)

Informacje o postępach w procesie weryfikacji tego klienta.

IdentityVerificationRequirement

Informacje o wymaganiach dotyczących weryfikacji w przypadku danego typu programu weryfikacji.

Zapis JSON
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
Pola
verificationStartDeadlineTime

string

Termin rozpoczęcia weryfikacji w formacie „rrrr-MM-dd GG:mm:ss”.

verificationCompletionDeadlineTime

string

Termin przesłania prośby o weryfikację.

IdentityVerificationProgress

Informacje o postępach weryfikacji w ramach programu weryfikacji.

Zapis JSON
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
Pola
programStatus

enum (IdentityVerificationProgramStatus)

Bieżący stan (PENDING_USER_ACTION, SUCCESS, FAILURE itp.)

actionUrl

string

Adres URL działania, który umożliwia użytkownikowi ukończenie weryfikacji w przypadku danego typu programu weryfikacji.

IdentityVerificationProgramStatus

Stan programu weryfikacji tożsamości.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
PENDING_USER_ACTION Działanie użytkownika wymaga weryfikacji.
PENDING_REVIEW Oczekiwanie na weryfikację.
SUCCESS Weryfikacja zakończona.
FAILURE Błąd weryfikacji.