تأیید تلفن

تأیید تلفن شامل دو روش حساب کاربری است که می‌توانید از آنها برای اضافه کردن و تأیید شماره تلفن برای یک حساب تجاری استفاده کنید. شماره تلفن‌های ارسال شده از طریق تأیید تلفن جایگزین شماره تلفن‌هایی می‌شوند که ممکن است از طریق accounts.AccountBusinessInformation ارسال کرده باشید.

تأیید شماره تلفن برای همه فروشندگان جدید و فعلی اکیداً توصیه می‌شود. در غیر این صورت، ممکن است حساب شما با مشکل وضعیت حساب PENDING_PHONE_VERIFICATION تا زمانی که شماره تلفن را تأیید نکنید، به حالت تعلیق درآید.

برای تأیید شماره تلفن، دو مرحله لازم است:

  1. برای شروع درخواست تأیید تلفن، accounts.requestphoneverification تماس بگیرید.
    کد منطقه دو حرفی خود را وارد کنید.
    شماره تلفن خود را وارد کنید.
    یک روش تأیید ( SMS یا PHONE_CALL ) انتخاب کنید.
  2. برای تأیید شماره تلفن، accounts.verifyphonenumber تماس بگیرید.
    verificationId مرحله ۱ را وارد کنید.
    verificationCode ۶ رقمی ارسال شده به تلفن همراهتان را وارد کنید.
    phoneVerificationMethod استفاده شده را وارد کنید.
    این فراخوانی یک verifiedPhoneNumber برمی‌گرداند. این شماره تلفن اکنون تأیید شده است.

می‌توانید وضعیت تأیید تلفن حساب خود را در AccountBusinessInformation.phoneVerificationStatus بررسی کنید.

حساب‌ها.درخواست تأیید تلفن

فرآیند تأیید شماره تلفن را با ارسال 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"
}

حساب‌ها.تایید شماره تلفن

با ارسال verificationId از accounts.requestphoneverification ، verificationCode شش رقمی ارسال شده به تلفن شما و phoneVerificationMethod که استفاده کرده‌اید، مثلاً SMS ، به accounts.verifyphonenumber ، شماره تلفن حساب را تأیید کنید. این فراخوانی شماره تلفن تأیید شده را با فرمت استاندارد برای منطقه شما برمی‌گرداند.

درخواست تأیید اولیه شما پس از ۱۵ دقیقه منقضی می‌شود. پس از آن، قبل از تماس با 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 بررسی کنید.

برای مشاهده اطلاعات تجاری حساب خود، متد accounts.get را با یک accountId و merchantId فراخوانی کنید:

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId