Method: customers.getIdentityVerification

本人確認情報を返します。

スローされるエラーのリスト: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。Google が確認情報をリクエストするお客様の ID。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

[IdentityVerificationService.GetIdentityVerification] に対するレスポンス メッセージです。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
フィールド
identityVerification[]

object (IdentityVerification)

お客様の本人確認のリスト。

承認スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 の概要をご覧ください。

IdentityVerification

お客様の本人確認。

JSON 表現 
{
  "verificationProgram": enum (IdentityVerificationProgram),
  "identityVerificationRequirement": {
    object (IdentityVerificationRequirement)
  },
  "verificationProgress": {
    object (IdentityVerificationProgress)
  }
}
フィールド
verificationProgram

enum (IdentityVerificationProgram)

適格性確認プログラムのタイプ。
identityVerificationRequirement

object (IdentityVerificationRequirement)

この顧客の適格性確認プログラムにおける確認要件。
verificationProgress

object (IdentityVerificationProgress)

このお客様の適格性確認プログラムの進捗状況に関する情報です。

IdentityVerificationRequirement

適格性確認プログラム タイプの適格性確認の要件に関する情報。

JSON 表現 
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
フィールド
verificationStartDeadlineTime

string

確認の開始期限（「yyyy-MM-dd HH:mm:ss」形式）。
verificationCompletionDeadlineTime

string

適格性確認の提出期限

IdentityVerificationProgress

適格性確認プログラム タイプの適格性確認の進捗状況に関する情報。

JSON 表現 
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
フィールド
programStatus

enum (IdentityVerificationProgramStatus)

現在のステータス（PENDING_USER_ACTION、SUCCESS、FAILURE など）
actionUrl

string

指定された適格性確認プログラムのタイプについて、ユーザーが確認を完了するためのアクション URL。

IdentityVerificationProgramStatus

本人確認のプログラムのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
PENDING_USER_ACTION 続行するためのユーザー操作の確認が保留中です。
PENDING_REVIEW 確認待ちの状態です。
SUCCESS 確認が正常に完了しました。
FAILURE 確認が失敗しました。