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

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

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

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

جلب خيارات إثبات الهوية

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

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

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

{
  "languageCode": "en"
}

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

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

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}:verify

// Use only one of the verification methods below

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

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

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

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

استرداد عمليات التحقّق الحالية

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

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

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

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

لإكمال عملية إثبات ملكية مؤسسة، يجب عادةً استخدام رمز PIN وطريقة 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. إذا كان requestAdminRightsUri متوفّرًا في GoogleLocation المطابق، يُرجى مساعدة التاجر في طلب الوصول إلى هذا الموقع الجغرافي وملكيته على "الملف التجاري على Google".
  4. إذا لم يكن requestAdminRightsUri متوفّرًا، يمكنك الاتصال بـ accounts.locations.create باستخدام تفاصيل location من GoogleLocation المطابق.
  5. أكِّد الموقع الجغرافي الجديد.

ملاحظة: إذا لم تظهر لك أي نتائج مطابقة للموقع الجغرافي من طلب البحث الأولي، اتصل بـ accounts.locations.create مع تفاصيل الموقع الجغرافي التي تم جمعها من التاجر، ثم تحقَّق من هذا الموقع الجغرافي الجديد.

التحقّق من الموقع الجغرافي

لبدء عملية التحقّق باستخدام واجهة برمجة التطبيقات GBP API، اتّبِع الخطوات التالية:

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

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

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