تتيح لك واجهة برمجة تطبيقات GoogleLocations معرفة ما إذا تمت المطالبة بملكية موقع جغرافي في "الملف التجاري". وبهذه الطريقة، إذا تمت المطالبة بالموقع الجغرافي، يمكنك على الفور طلب الدخول إلى الموقع الجغرافي. بالإضافة إلى ذلك، إذا كنت تدير حسابات تم إثبات ملكيتها بشكلٍ مجمّع، يمكنك اختيار مطابقات محتملة بدقة أكبر وتجنُّب إنشاء مواقع جغرافية مكرّرة.
تعرض نقطة نهاية واجهة برمجة التطبيقات عنوان URL يشير إلى ما إذا تمت المطالبة بموقع جغرافي من قبل. وإذا تمّت المطالبة بملكيته، يسمح لك عنوان URL نفسه ببدء عملية طلب الوصول.
تقدّم الصورة التالية نظرة عامة حول عملية الحصول على ملكية موقع جغرافي.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/locations1.png?authuser=8&hl=ar)
تسمح لك الخطوات التالية باستخدام واجهة برمجة التطبيقات GoogleLocations
:
- جمع بيانات الموقع الجغرافي من التاجر
-
اطلب نقطة نهاية
googleLocations.search
. قدِّم بيانات الموقع الجغرافي داخل نص المكالمة. ويمكنك أيضًا تقديمه في سلسلة طلب بحث، تمامًا كما أدخله المستخدم في "بحث Google " أو "خرائط Google ". على سبيل المثال، &;;Starbucks; 5th ave NY."تعرض واجهة برمجة التطبيقات قائمة بالمواقع الجغرافية التي يُحتمل أن تكون متطابقة ومعلومات حول كل موقع جغرافي، مثل
locationName
والعنوان. - اختَر الموقع الجغرافي الذي يطابق موقعك الجغرافي. إذا لم تكن هناك نتائج مطابقة، اتّصِل
accounts.locations.create
، وانتقِل إلى الخطوة 5. -
بناءً على حالة
requestAdminRightsUrl
في الرد، عليك اتخاذ الإجراءات التالية:- في حال وجود
requestAdminRightsUrl
، يمتلك مستخدم آخر ملكية بطاقة البيانات. وجِّه التاجر إلى عنوان URL لبدء طلب بالوصول إلى الموقع الجغرافي الحالي وملكيته في "الملف التجاري". - في حال عدم توفّر
requestAdminRightsUrl
، يمكنك الاتصالaccounts.locations.create
وإنشاء بطاقة بيانات جديدة سيتم إثبات ملكيتها لاحقًا.
- في حال وجود
- إذا أنشأت بيانات جديدة كجزء من هذه العملية، يمكنك استخدام واجهات برمجة التطبيقات لإثبات الملكية لبدء إثبات ملكية البيانات. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة عملية إثبات الملكية.