تتضمّن واجهة برمجة التطبيقات لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات. يُرجى مراجعة الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك GoogleLocations API معرفة ما إذا تم
المطالبة بموقع جغرافي في "الملف التجاري على Google" مسبقًا. بهذه الطريقة، إذا تمّت المطالبة بالموقع الجغرافي، يمكنك
طلب الوصول إليه على الفور. بالإضافة إلى ذلك، إذا كنت تدير حسابات تم إثبات ملكيتها بشكلٍ مجمّع، يمكنك تحديد المطابقات المحتملة مسبقًا بدقة أكبر وتجنُّب إنشاء مواقع جغرافية مكرّرة.
تعرض نقطة نهاية واجهة برمجة التطبيقات عنوان URL يشير إلى ما إذا سبق أن تمّت المطالبة بموقع جغرافي. إذا كان قد
تمّت المطالبة به، يتيح لك عنوان URL نفسه بدء عملية طلب الوصول.
تقدّم الصورة التالية نظرة عامة على عملية اكتساب ملكية موقع جغرافي.
الشكل 1. مخطّط بياني للمسارات المتعلّقة بملكية الموقع الجغرافي للملف التجاري
تتيح لك الخطوات التالية استخدام واجهة برمجة التطبيقات GoogleLocations:
جمع بيانات الموقع الجغرافي من التاجر
اتصل بنقطة نهاية
googleLocations.search. قدِّم بيانات الموقع الجغرافي في نص المكالمة. بدلاً من ذلك، يمكنك تقديمه في سلسلة طلب بحث، مثل ما قد يُدخله المستخدم في "بحث Google" أو "خرائط Google". على سبيل المثال،
"Starbucks 5th ave NYC".
تعرض واجهة برمجة التطبيقات قائمة بالمواقع الجغرافية التي يُحتمل أن تتطابق مع طلبك ومعلومات عن كل موقع جغرافي،
مثل locationName والعنوان.
اختَر الموقع الجغرافي الذي يطابق موقعك الجغرافي. إذا لم يتم العثور على أي مطابقات، اتصل بالرقم accounts.locations.create وانتقِل إلى الخطوة 5.
استنادًا إلى حالة requestAdminRightsUrl في الردّ، اتّخِذ
الإجراءات التالية:
إذا كان requestAdminRightsUrl متوفّرًا، يعني ذلك أنّ مستخدمًا آخر يملك بيانات المنتج.
وجِّه التاجر إلى عنوان URL لبدء طلب الوصول إلى الموقع الجغرافي الحالي
وملكيته في "الملف التجاري".
إذا لم يكن requestAdminRightsUrl متوفّرًا، يُرجى الاتصال بـ
accounts.locations.create
وإنشاء بيانات جديدة سيتم إثبات ملكيتها لاحقًا.
إذا أنشأت بيانات جديدة كجزء من هذه العملية، يمكنك استخدام واجهات برمجة التطبيقات الخاصة بإثبات الملكية لبدء عملية إثبات ملكية البيانات. لمزيد من المعلومات، يُرجى الاطّلاع على
إدارة عملية إثبات الملكية.
تاريخ التعديل الأخير: 2025-01-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-01-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings."],["Use the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed."],["If a new listing is created, leverage verification APIs to complete the setup process."],["This API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis."]]],[]]
