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

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

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

يمكن للمستخدمين الاتصال برقم 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 " باستخدام واجهة برمجة التطبيقات

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

باستخدام واجهة برمجة التطبيقات 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. في حال إعادة إثبات الملكية، اتصِل بالرقم fetchVerificationOptions للحصول على قائمة بالطرق المتاحة لإثبات صحة ذلك الموقع الجغرافي.
  5. تأكَّد من أنّ بيانات verificationOption تحتوي على العنوان ورقم الهاتف وعنوان البريد الإلكتروني الصحيحة.
  6. بعد أن تختار الآلية أفضل خيار متاح لإثبات الملكية، اتّصِل باستخدام طريقة locations.verify لبدء عملية إثبات الملكية المناسبة. للتأكد من أن عملية البدء قيد التقدم، اتصل بـ locations.verifications.list.
  7. استدعِ طريقة locations.verification.complete باستخدام رقم التعريف الشخصي للتاجر.
  8. استدعِ طريقة واجهة برمجة التطبيقات GetVoiceOfMerchant. إذا HasVoiceOfMerchant = true، تكون قد أثبتت ملكية الموقع الجغرافي بنجاح.

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

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

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