Method: customers.getIdentityVerification

מחזירה מידע על אימות הזהות.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. מספר הלקוח שאנחנו מבקשים עבורו פרטי אימות.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

הודעת תשובה לגבי [IdentityAuthenticationService.GetIdentityentity].

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "identityVerification": [
    {
      object (IdentityVerification)
    }
  ]
}
שדות
identityVerification[]

object (IdentityVerification)

רשימה של תהליכי אימות הזהות של הלקוח.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

IdentityVerification

אימות זהות (IDV) של לקוח.

ייצוג 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, הצלחה, FAILURE וכו')
actionUrl

string

כתובת URL לפעולה שבה המשתמש ישלים את האימות של סוג תוכנית האימות הנתון.

IdentityVerificationProgramStatus

סטטוס התוכנית של אימות הזהות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
PENDING_USER_ACTION האימות בהמתנה לפעולה של המשתמש כדי להמשיך.
PENDING_REVIEW האימות בהמתנה לבדיקה.
SUCCESS האימות בוצע בהצלחה.
FAILURE האימות נכשל.