إدارة إثبات ملكية الموقع

يمكن لمقدّمي الخدمات الذين يوفّرون إدارة البيانات على منصّاتهم مباشرةً إثبات ملكية التاجر لنشاطه التجاري على موقعهم الإلكتروني. ويؤدي ذلك إلى عدم الحاجة إلى إعادة توجيه التاجر إلى واجهة مستخدم ملفه التجاري.

الحصول على الحالة الحالية

يمكن للمستخدمين الاتصال برقم locations.getVoiceOfMerchantState في أحد المواقع الجغرافية لاسترداد حالته الحالية. إذا كانت قيمة القيمة المنطقية hasVoiceOfMerchant هي true، يعني ذلك أنّ الموقع الجغرافي في وضع جيد ولا يلزم اتّخاذ أي إجراء إضافي. في حال عدم توفّر ذلك الدليل، إذا كان إجراء gain_voice_of_merchant في الاستجابة يحتوي على verify، عليك إكمال عملية إثبات الهوية. اتّبِع التعليمات أدناه للحصول على مزيد من المعلومات.

جلب خيارات إثبات الملكية

يمكن لموفّري الخدمة استخدام الرمز locations.fetchVerificationOptions لطلب من التجّار اختيار طريقة التواصل المفضّلة من قائمة طرق إثبات الملكية المتاحة.

لجلب خيارات إثبات الملكية، استخدِم ما يلي:

بروتوكول HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

بدء عملية إثبات الهوية

بعد اختيار طريقة إثبات الملكية، ابدأ عملية إثبات الملكية مع locations.verify. نتيجةً لهذه المكالمة، يتم نقل الموقع الجغرافي إلى حالة تم إثبات ملكيته أو يتم عرض حالة خطأ.

بروتوكول HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

استرداد عمليات إثبات الهوية الحالية

تسترجع المكالمة locations.verifications.list سجلّ طلبات إثبات الهوية بالإضافة إلى حالتها للموقع الجغرافي المحدّد في المكالمة.

لاسترداد جميع طلبات إثبات الملكية، استخدِم ما يلي:

بروتوكول HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

إكمال عملية إثبات الهوية في انتظار المراجعة

عادةً ما يكون رقم التعريف الشخصي وطريقة locations.verifications.complete مطلوبَين لإكمال عملية إثبات ملكية النشاط التجاري.

لإكمال عملية إثبات الهوية في انتظار المراجعة، يُرجى اتّباع الخطوات التالية:

بروتوكول HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

أفضل الممارسات للتحقّق من ملكية "الملف التجاري على Google" باستخدام واجهة برمجة التطبيقات

إنشاء موقع جغرافي

باستخدام Business Information API في "الملف التجاري على Google"، يمكنك تضمين منصتك لتوفير وظيفة إنشاء المواقع الجغرافية. عند مطالبة التجّار بإضافة موقع جديد، احرص على اتّباع الخطوات التالية:

جمع معلومات الموقع الجغرافي من التاجر، مثل اسم النشاط التجاري والعنوان والفئة

  1. اتصل بنقطة النهاية googleLocations.search.
  2. قدِّم بيانات الموقع الجغرافي، مثل اسم النشاط التجاري وفئة النشاط التجاري والعنوان ورقم الهاتف والموقع الإلكتروني ضمن طلب البيانات من واجهة برمجة التطبيقات.

يمكنك بدلاً من ذلك إجراء بحث عن موقع جغرافي مطابق محتمل باتّباع الخطوات التالية:

  1. ابحث عن المطابقات المحتملة للمواقع الجغرافية.
  2. اطلب من التاجر اختيار الموقع الجغرافي الصحيح.
  3. إذا كان requestAdminRightsUrl متوفّرًا في استجابة الموقع الجغرافي، يمكنك مساعدة التاجر في طلب الوصول إلى هذا الموقع الجغرافي وملكيته في "الملف التجاري على Google".
  4. إذا لم يكن requestAdminRightsUrl متوفّرًا، أنشئ موقعًا جغرافيًا جديدًا باستخدام معرّف المكان في استجابة الموقع الجغرافي.
  5. تأكَّد من صحة الموقع الجغرافي الجديد.

ملاحظة: إذا لم تعثر على أي مطابقات ممكنة للمواقع الجغرافية من طلب البحث الأولي، استخدِم معرّف مكان فارغًا لإنشاء موقع جغرافي جديد. بعد ذلك، عليك إثبات صحة هذا الموقع الجغرافي الجديد.

إثبات ملكية الموقع الجغرافي

لبدء عملية إثبات الملكية باستخدام واجهة GBP API، يُرجى اتّباع الخطوات التالية:

  1. يمكنك استدعاء الطريقة accounts.locations.list لعرض جميع المواقع الجغرافية لحساب Google.
  2. اختَر موقعًا جغرافيًا لإثبات ملكيته.
  3. يمكنك الاتصال بطريقة واجهة برمجة التطبيقات GetVoiceOfMerchant لتأكيد ما إذا كان هذا الموقع الجغرافي يتطلّب إثبات الملكية.
  4. إذا كان الردّ يشير إلى أنّه يجب إثبات الملكية، يُرجى الاتصال بـ fetchVerificationOptions للحصول على قائمة بالطرق المتاحة لإثبات ملكية هذا الموقع الجغرافي.
  5. تحقَّق من أنّ بيانات verificationOption تتضمّن العنوان ورقم الهاتف وعنوان البريد الإلكتروني الصحيحَين.
  6. بعد أن يختار التاجر أفضل خيار متاح لإثبات الملكية، يجب استدعاء طريقة locations.verify لبدء عملية إثبات الملكية المناسبة. للتأكّد من أنّ عملية البدء قيد التقدّم، يُرجى الاتصال بالرقم locations.verifications.list..
  7. استخدِم طريقة locations.verification.complete مع إدخال رقم التعريف الشخصي للتاجر.
  8. استدعاء طريقة واجهة برمجة التطبيقات GetVoiceOfMerchant إذا كانت الإجابة HasVoiceOfMerchant = true، يعني ذلك أنّك أثبت ملكية الموقع الجغرافي بنجاح.

ملاحظة: إذا كان إثبات صحة معلومات الموقع الجغرافي AUTO متاحًا، لن يحتاج التاجر إلى تنفيذ أي خطوات إثبات صحة.

لمزيد من المعلومات حول إثبات ملكية حساب Google Play للأعمال، يُرجى الرجوع إلى مقالة الدعم في مركز المساعدة.

دليل طرق إثبات هوية الشركاء الذين تم التحقّق منهم