אימות טלפוני

אימות טלפוני כולל שתי שיטות לחשבונות שבהן אפשר להשתמש כדי להוסיף ולאמת מספרי טלפון בחשבון מוכר. מספרי טלפון שנשלחו באמצעות אימות טלפוני מחליפים את מספרי הטלפון שייתכן ששלחתם באמצעות accounts.AccountBusinessInformation.

אימות טלפוני מומלץ מאוד לכל המוכרים החדשים והקיימים. במקרים אחרים, החשבון עלול להיות מושעה עם סטטוס החשבון PENDING_PHONE_VERIFICATION עד לאימות מספר הטלפון.

יש שני שלבים שצריך לבצע כדי לאמת מספר טלפון:

  1. יש להתקשר אל accounts.requestphoneverification כדי להתחיל בקשה לאימות טלפוני.
    מזינים את קוד האזור בן שתי האותיות.
    מזינים את מספר הטלפון.
    בוחרים שיטת אימות (SMS או PHONE_CALL).
  2. אפשר להתקשר אל accounts.verifyphonenumber כדי לאמת את מספר הטלפון.
    מזינים את הverificationId משלב 1.
    יש להזין את 6 הספרות של verificationCode שנשלחו לטלפון.
    יש להזין את הערך של phoneVerificationMethod שבו נעשה שימוש.
    השיחה מחזירה verifiedPhoneNumber. מספר הטלפון הזה מאומת.

אתם יכולים לבדוק את הסטטוס של האימות הטלפוני בחשבון שלכם ב-AccountBusinessInformation.phoneVerificationStatus.

accounts.requestphoneverification

כדי להתחיל את תהליך האימות של מספר הטלפון, מעבירים את התגים phoneRegionCode, phoneNumber ו-phoneVerificationMethod אל accounts.requestphoneverification. השיחה מחזירה verificationId.

אפשר להשתמש בשדה האופציונלי languageCode כדי לבצע אימות בשפה שאינה ברירת המחדל (אנגלית ארה"ב).

תוכלו לנסות לאמת את אותו מספר טלפון עד חמש פעמים בכל ארבע שעות.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

זוהי שיחה לדוגמה:

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

זוהי דוגמה לתשובה:

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

accounts.verifyphonenumber

כדי לאמת את מספר הטלפון של החשבון, מעבירים את verificationId מהקוד accounts.requestphoneverification, את המספר בן 6 הספרות של verificationCode שנשלח לטלפון ואת מספר phoneVerificationMethod שבו השתמשתם, לדוגמה SMS, אל accounts.verifyphonenumber. השיחה תחזיר את מספר הטלפון המאומת ב-fomat רגיל לאזור שלך.

בקשת האימות הראשונית תפוג לאחר 15 דקות. לאחר מכן צריך לשלוח בקשה חדשה לאימות מספר הטלפון לפני שמתקשרים אל accounts.verifyphonenumber.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

זוהי שיחה לדוגמה:

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

זוהי דוגמה לתשובה:

{
  "verifiedPhoneNumber": "(123) 456-7890"
}

AccountBusinessInformation.phoneVerificationStatus

אפשר לבדוק את הסטטוס של האימות הטלפוני בחשבון בשדה AccountBusinessInformation.phoneVerificationStatus.

כדי להציג את פרטי העסק של החשבון, מפעילים את השיטה accounts.get עם accountId ועם merchantId:

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId