Method: customers.getIdentityVerification

تعرِض معلومات إثبات الهوية.

قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. الرقم التعريفي للعميل الذي نطلب منه معلومات إثبات الهوية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة ردّ تخصّ [IdentityالتحقّقService.GetIdentity Verification].

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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، False، FAILURE، وما إلى ذلك)
actionUrl

string

عنوان URL للإجراء الذي يمكن للمستخدم إكمال عملية التحقّق من أجل نوع برنامج التحقّق من المعلِنين المحدّد

IdentityVerificationProgramStatus

حالة البرنامج لإثبات الهوية.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
PENDING_USER_ACTION يُرجى العِلم أنّ عملية إثبات الملكية في انتظار المراجعة لاتخاذ إجراء من قِبل المستخدم للمتابعة.
PENDING_REVIEW يُرجى العِلم أنّ عملية إثبات الملكية في انتظار المراجعة.
SUCCESS تم إثبات الملكية بنجاح.
FAILURE تعذّر التحقق.