אימות טלפוני

אימות הטלפון כולל שתי שיטות לאימות חשבונות שבהן אפשר להשתמש כדי להוסיף ולאמת מספרי טלפון בחשבון מוֹכרים. מספרי טלפון שנשלחים דרך אימות טלפוני מחליפים מספרי טלפון שאולי שלחתם דרך 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, את verificationCode בן שש הספרות שנשלח לטלפון ואת phoneVerificationMethod שבו השתמשת, למשל SMS, אל accounts.verifyphonenumber. השיחה הזו מחזירה את מספר הטלפון המאומת בפורמט סטנדרטי לאזור שלכם.

התוקף של בקשת האימות הראשונית פג אחרי 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