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

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

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

يمكن للمستخدمين الاتصال بـ 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"، يُرجى الرجوع إلى مقالة الدعم حول مركز المساعدة.

دليل طرق التحقّق للشركاء الذين تم التحقّق منهم