אימות טלפוני מורכב משתי שיטות שבהן אפשר להשתמש בחשבון כדי להוסיף ולאמת מספרי טלפון לחשבון של מוכר.
מספרי טלפון שנשלחים דרך אימות טלפוני מחליפים את מספרי הטלפון ששלחתם דרך accounts.AccountBusinessInformation
.
אימות טלפוני מומלץ מאוד לכל המוכרים החדשים והקיימים. אחרת, יכול להיות שהחשבון יושעה עם הבעיה PENDING_PHONE_VERIFICATION
בסטטוס החשבון עד שתאמתו מספר טלפון.
כדי לאמת מספר טלפון, צריך לבצע שני שלבים:
- כדי להגיש בקשה לאימות טלפוני, צריך להתקשר למספר
accounts.requestphoneverification
. - מזינים את קוד האזור בן שתי האותיות.
- מזינים את מספר הטלפון.
- בוחרים שיטת אימות (
SMS
אוPHONE_CALL
).
- כדי להגיש בקשה לאימות טלפוני, צריך להתקשר למספר
- כדי לאמת את מספר הטלפון, צריך להתקשר אל
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
כדי לאמת את מספר הטלפון של החשבון, צריך להעביר אל accounts.verifyphonenumber
את verificationId
מ-accounts.requestphoneverification
, את verificationCode
בן 6 הספרות שנשלח לטלפון שלך ואת phoneVerificationMethod
שבו השתמשת, למשל SMS
.
השיחה מחזירה את מספר הטלפון המאומת בפורמט רגיל בהתאם לאזור שלכם.
התוקף של בקשת האימות הראשונית יפוג אחרי 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