Method: customers.getIdentityVerification

اطلاعات تأیید هویت را برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری که اطلاعات تأیید را برای او درخواست می کنیم.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پیام پاسخ برای [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 )

اطلاعات مربوط به پیشرفت این برنامه تأیید برای این مشتری.

IdentityVerification Requirement

اطلاعات مربوط به الزامات تأیید برای نوع برنامه تأیید.

نمایندگی JSON
{
  "verificationStartDeadlineTime": string,
  "verificationCompletionDeadlineTime": string
}
زمینه های
verificationStartDeadlineTime

string

آخرین مهلت برای شروع راستی‌آزمایی در قالب «سالم-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

وضعیت برنامه تأیید هویت

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
PENDING_USER_ACTION تأیید در انتظار اقدام کاربر برای ادامه است.
PENDING_REVIEW تأیید در انتظار بررسی است.
SUCCESS راستی‌آزمایی با موفقیت انجام شد.
FAILURE تأیید ناموفق بود.