Method: customers.getIdentityVerification

Trả về thông tin Xác minh danh tính.

Danh sách các lỗi đã gửi: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customerId

string

Bắt buộc. Mã của khách hàng mà chúng tôi đang yêu cầu cung cấp thông tin xác minh.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho [IdentityVerifyService.GetIdentityVerify].

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
Trường
identityVerification[]

object (IdentityVerification)

Danh sách xác minh danh tính của khách hàng.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

IdentityVerification

Xác minh danh tính cho khách hàng.

Biểu diễn dưới dạng JSON 
{
  "verificationProgram": enum (IdentityVerificationProgram),
  "identityVerificationRequirement": {
    object (IdentityVerificationRequirement)
  },
  "verificationProgress": {
    object (IdentityVerificationProgress)
  }
}
Trường
verificationProgram

enum (IdentityVerificationProgram)

Loại chương trình xác minh.
identityVerificationRequirement

object (IdentityVerificationRequirement)

Yêu cầu xác minh đối với chương trình xác minh này đối với khách hàng này.
verificationProgress

object (IdentityVerificationProgress)

Thông tin về tiến trình của chương trình xác minh này cho khách hàng này.

IdentityVerificationRequirement

Thông tin về yêu cầu xác minh đối với loại chương trình xác minh.

Biểu diễn dưới dạng JSON 
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
Trường
verificationStartDeadlineTime

string

Thời hạn để bắt đầu xác minh ở định dạng "yyyy-MM-dd HH:mm:ss".
verificationCompletionDeadlineTime

string

Thời hạn để gửi thông tin xác minh.

IdentityVerificationProgress

Thông tin về tiến trình xác minh cho một loại chương trình xác minh.

Biểu diễn dưới dạng JSON 
{
  "programStatus": enum (IdentityVerificationProgramStatus),
  "invitationLinkExpirationTime": string,
  "actionUrl": string
}
Trường
programStatus

enum (IdentityVerificationProgramStatus)

Trạng thái hiện tại (PENDING_USER_ACTION, THÀNH CÔNG, FAILURE, v.v.)
actionUrl

string

URL hành động để người dùng hoàn tất quy trình xác minh cho loại chương trình xác minh đã chỉ định.

IdentityVerificationProgramStatus

Trạng thái xác minh danh tính của chương trình.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
PENDING_USER_ACTION Quy trình xác minh đang chờ xử lý khi người dùng thực hiện hành động.
PENDING_REVIEW Yêu cầu xác minh đang chờ xem xét.
SUCCESS Xác nhận thành công.
FAILURE Xác minh không thành công.