אימות טלפוני

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