אימות טלפוני

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