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