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

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

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

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

استرداد خيارات تأكيد الحساب

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

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

POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

بدء عملية التحقّق من الهوية

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

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 سجلّ طلبات التحقّق وحالتها للموقع الجغرافي المحدّد في الطلب.

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

GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

إكمال عملية تأكيد في انتظار المراجعة

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

لإكمال عملية إثبات هوية معلّقة، استخدِم ما يلي:

POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

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

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

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

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

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

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

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

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

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

لبدء عملية إثبات الملكية باستخدام واجهة برمجة التطبيقات الخاصة بـ "نشاطي التجاري على Google"، يُرجى اتّباع الخطوات التالية:

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

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

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