Method: customers.getIdentityVerification

傳回身分驗證資訊。

擲回錯誤清單：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。我們要求取得驗證資訊的客戶 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

供使用者針對特定驗證計畫類型完成驗證的動作網址。

IdentityVerificationProgramStatus

身分驗證計畫狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
PENDING_USER_ACTION 正在等待使用者採取動作，才能繼續進行驗證。
PENDING_REVIEW 驗證尚待審查。
SUCCESS 驗證成功。
FAILURE 無法驗證。