إثبات ملكية الحساب عبر الهاتف

يتألف إثبات ملكية الحساب عبر الهاتف من طريقتين للحساب يمكنك استخدامهما لإضافة أرقام الهاتف لحساب التاجر وإثبات ملكيته. تحل أرقام الهواتف المرسَلة من خلال عملية إثبات ملكية الهاتف محل أرقام الهواتف التي يمكن أن تكون قد أرسلتها عبر accounts.AccountBusinessInformation.

ننصح بشدة بإثبات ملكية الحساب عبر الهاتف لجميع التجّار الجُدد والحاليين. قد يتم تعليق حسابك بسبب مشكلة حالة الحساب PENDING_PHONE_VERIFICATION إلى أن تثبت ملكية رقم هاتف.

هناك خطوتان مطلوبتان لإثبات ملكية رقم هاتف:

  1. اتصل بالرقم accounts.requestphoneverification لبدء طلب التحقق من رقم الهاتف.
    أدخِل رمز المنطقة المكوَّن من حرفين.
    إدخال رقم هاتفك
    يُرجى اختيار طريقة إثبات الملكية (SMS أو PHONE_CALL).
  2. يمكنك الاتصال بالرقم accounts.verifyphonenumber لإثبات ملكية رقم الهاتف.
    أدخِل verificationId من الخطوة 1.
    يُرجى إدخال الرقم verificationCode المكوَّن من 6 أرقام الذي تم إرساله إلى هاتفك.
    أدخِل 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