Method: customers.getIdentityVerification

返回身份验证信息。

抛出的错误列表：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 请求

GET https://googleads.googleapis.com/v17/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 验证失败。