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

يتضمّن إثبات ملكية الهاتف طريقتَين من طرق الحسابات يمكنك استخدامهما لإضافة أرقام هواتف وإثبات ملكيتها لحساب تاجر. إنّ أرقام الهواتف التي يتم إرسالها من خلال عملية إثبات ملكية رقم الهاتف تحلّ محل أرقام الهواتف التي ربما أرسلتها من خلال 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 المؤلّف من ستة أرقام الذي تم إرساله إلى هاتفك، و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