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

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