الأسئلة الشائعة

ما هي واجهات برمجة تطبيقات "الملف التجاري على Google"؟

واجهات برمجة التطبيقات Business Profile API هي واجهات برمجة تتيح للمطوّرين كتابة تطبيقات لإدارة حساباتهم على "الملف التجاري على Google" وبيانات الموقع الجغرافي. تسمح واجهات برمجة التطبيقات للتجار أو ممثليهم بإدارة طريقة عرض بياناتهم على خدمات Google المختلفة وتحديد مَن يشاركون في إدارة بياناتهم. يمكن أيضًا إدارة البيانات التي ينشئها المستخدم، مثل الصور والمشاركات والمراجعات، من خلال واجهات برمجة التطبيقات.

وتوفّر واجهات برمجة التطبيقات للملف التجاري الميزات نفسها تقريبًا التي توفّرها واجهة مستخدم "الملف التجاري"، مع بعض الميزات الإضافية الخاصة بواجهات برمجة التطبيقات. ويمكن لمستخدمي واجهات برمجة التطبيقات توقُّع حدوث تحديثات Google تمامًا كما يحدث لمستخدمي واجهة المستخدم.

مَن يمكنه الوصول إلى واجهات برمجة تطبيقات "الملف التجاري على Google"؟

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

• استخدِم عنوان بريد إلكتروني صالحًا للنشاط التجاري ومرتبطًا بنطاق نشاطك التجاري.
• تأكَّد من أنّ الموقع الإلكتروني للنشاط التجاري محدَّث ومنشور على الإنترنت.

هل إمكانية الوصول إلى واجهات برمجة تطبيقات "الملف التجاري على Google" تتيح للمستخدم إجراء طلب بحث عن أي بيانات في "الملف التجاري على Google"؟

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

ما هي السياسات ذات الصلة لمستخدمي واجهة برمجة تطبيقات "الملف التجاري على Google"؟

وعلى الشركاء الالتزام بسياسات "الملف التجاري على Google" وجميع سياسات واجهة برمجة التطبيقات والأحكام والشروط.

كيف يمكن للمستخدمين الوصول إلى واجهة برمجة تطبيقات "الملف التجاري على Google"؟

لإنشاء تطبيق العميل الأول بنجاح، يجب إكمال المتطلبات الأساسية التالية:

1. الحصول على حساب على Google
2. تجربة "الملف التجاري"
3. أنشئ مشروعًا في وحدة التحكم في واجهة Google API.
4. طلب الوصول إلى واجهة برمجة التطبيقات: تتم مراجعة الطلبات في غضون 14 يومًا.

كيف يمكن للمستخدمين الوصول إلى واجهة برمجة تطبيقات معيّنة ضمن واجهة برمجة تطبيقات "الملف التجاري على Google"؟

هناك ثمانية واجهات برمجة تطبيقات مرتبطة بالملف التجاري ويجب تفعيلها في وحدة التحكم في واجهة Google API:

• الإصدار 4.9 من واجهة برمجة التطبيقات لـ "نشاطي التجاري على Google"، يتضمن الميزات المهمة التالية لطلب البيانات من واجهة برمجة التطبيقات:
  • FoodMenus
  • Media
  • Reviews
  • LocalPosts
• واجهة برمجة تطبيقات إدارة حساب نشاطي التجاري
• واجهة برمجة تطبيقات أماكن إقامة نشاطي التجاري
• واجهة برمجة تطبيقات إجراءات الأماكن في نشاطي التجاري
• My Business Notifications API
• واجهة برمجة التطبيقات للتحقق من حساب نشاطي التجاري
• واجهة برمجة تطبيقات معلومات نشاطي التجاري
• واجهة برمجة التطبيقات للأسئلة والأجوبة المتعلقة بنشاطي التجاري
• واجهة برمجة تطبيقات أداء الملف التجاري

وإذا تمت الموافقة على طلب المستخدم للوصول إلى البيانات، يتم منحه حصة تلقائية عادية لجميع واجهات برمجة التطبيقات الثمانية.

كيف يعمل الوصول إلى واجهة برمجة تطبيقات "الملف التجاري على Google"؟

يتم منح الوصول إلى واجهة برمجة تطبيقات "الملف التجاري على Google" على مستوى مشروع Google Cloud. إذا قدّم المستخدم "أ" طلبًا للوصول إلى Google Business Profile API للمشروع رقم 12345678، سيتم منح إذن الوصول إلى المشروع رقم - 12345678. وبالتالي، يمكن لأي مستخدم، بما في ذلك المستخدم "أ" لديه إمكانية الوصول إلى مشروع Google Cloud، إجراء اتصالات بواجهات برمجة تطبيقات الملف التجاري على Google. يجب أن يتحكم الشركاء في إمكانية الوصول إلى مشروع Google Cloud عند الحاجة إلى الوصول لتجنّب إساءة الاستخدام.

هل لديك ملخّص عن واجهات برمجة التطبيقات وأمثلة على الإمكانات؟

ارجع إلى الجدول التالي للتعرف على واجهات برمجة التطبيقات المختلفة وقدراتها.

API	المستندات المرجعية	أمثلة على الإمكانات
Account Management API	الوثائق	إدارة الوصول إلى أحد المواقع الجغرافية يتم إنشاء حساب بالاسم والنوع المحدّدين ضمن حساب رئيسي معيّن. يسرد جميع حسابات المستخدم الذي تمت المصادقة عليه. يسرد الدعوات التي في انتظار المراجعة للحساب المحدّد. ينقل موقعًا جغرافيًا من حساب يملكه المستخدم إلى حساب آخر تحديث المشرف للموقع الجغرافي المحدّد.
واجهة برمجة تطبيقات معلومات النشاط التجاري	الوثائق	تسمح واجهة Business Information API بإدارة مراحل نشاط الملف التجاري وإضافة معلومات النشاط التجاري أو إدارتها في "الملف التجاري على Google". يسمح للتجّار بإنشاء الملفات التجارية على Google أو إنشائها أو تعديلها أو حذفها. يتيح هذا الخيار للتجّار الحصول على سمات الملف التجاري أو تعديلها. يسمح للتجّار بالحصول على السلاسل وفئات الملفات الشخصية أو البحث عنها.
واجهة برمجة تطبيقات أماكن الإقامة	الوثائق	تتيح إدارة بيانات أماكن الإقامة، مثل وسائل الراحة في المنشآت والسياسات للأنشطة التجارية على Google. تقتصر واجهة برمجة التطبيقات على الأنشطة التجارية التي تقدّم خدمات الإقامة، مثل الفنادق. تتيح واجهة برمجة التطبيقات Lodging API للمطوّرين تعديل سمات أماكن الإقامة في "الملف التجاري على Google".
واجهة برمجة تطبيقات إجراءات المكان	الوثائق	تسمح بإدارة روابط الإجراءات المستندة إلى المكان في الأنشطة التجارية. إعادة توجيه المستخدمين لاتخاذ إجراءات مثل حجز موعد أو حجز طاولة أو طلب توصيل الطعام
Notifications API	الوثائق	تمكِّنك هذه السياسة من إدارة إعدادات الإشعارات في حسابات محدّدة.
verifications API	الوثائق	لبدء عملية إثبات ملكية موقع جغرافي تعمل هذه السياسة على إعداد تقارير عن جميع خيارات إثبات الملكية المؤهَّلة لموقع جغرافي معيّن بلغة معيّنة.
واجهة برمجة التطبيقات للأسئلة والأجوبة	الوثائق	يتيح إدارة الأسئلة والأجوبة للموقع الجغرافي.
واجهة برمجة تطبيقات أداء الملف التجاري	الوثائق	السماح للتجّار بجلب إحصاءات الأداء حول بيانات نشاطهم التجاري على Google تشمل الإحصاءات مرات ظهور النشاط التجاري، وطلبات الاتجاهات، والنقرات على زر الاتصال، والنقرات على الموقع الإلكتروني، والحجوزات، وطلبات الطعام، والتفاعلات في القائمة، والمزيد.
Media API	الوثائق	تسمح لمطوّري واجهة برمجة التطبيقات بتحميل الصور والفيديوهات لملف تجاري.
Reviews API	الوثائق	يتيح هذا الخيار للتجّار الحصول على المراجعات والردّ على المراجعات في ملف تجاري.
واجهة برمجة تطبيقات المشاركات المحلية	الوثائق	يتيح ذلك للتجّار الحصول على مشاركات محلية أو إنشائها أو تعديلها.
واجهة برمجة تطبيقات Food Menus	الوثائق	يسمح للتجار بالحصول على قوائم الطعام أو إنشاؤها أو تعديلها لملف تجاري.

كيف يمكن للشركاء إعداد بنية حساباتهم لاستخدام واجهات برمجة تطبيقات "الملف التجاري على Google"؟

إذا كنت شريكًا تابعًا لجهة خارجية وتتولى إدارة بطاقات البيانات للأنشطة التجارية:

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

كيف تمنح الأنشطة التجارية تفويضًا لشريك واجهة برمجة تطبيقات "الملف التجاري على Google" لإدارة بيانات نشاطها التجاري؟

تمنح الأنشطة التجارية إذن الوصول إلى شريك خارجي بطريقتَين:

• إعداد OAuth: يمكنك الرجوع إلى هذا الدليل لفهم كيفية استخدام منصات الشركاء التابعة لجهات خارجية لبيانات اعتماد التاجر لتعديل بيانات "الملف التجاري على Google" والوصول إليها نيابةً عن التاجر أو النشاط التجاري.

• إذن وصول المالك أو المدير: إذا أضاف التاجر شريكًا تابعًا لجهة خارجية كمدير للملف التجاري على Google، من المفترض أن يكون المالك الأساسي لـ "الملف التجاري على Google"، لن يحتاج هذا الشريك إلى استخدام بيانات اعتماد التاجر لاستخدام واجهات برمجة تطبيقات "الملف التجاري على Google" من أجل تعديل بيانات "الملف التجاري على Google" والوصول إليها.

  ملاحظة: ننصح بشدّة ألا يتولّى الشركاء الخارجيون تصنيف أنفسهم كمالكين للجنيه الإسترليني ولكنهم يضيفون أنفسهم فقط كمديرين.

إذا كان للنشاط التجاري أكثر من 10 مواقع جغرافية، هل هناك طريقة لإثبات الملكية بشكلٍ مجمّع؟

نعم. يمكنك طلب إثبات الملكية بشكلٍ مجمّع لأكثر من 10 ملفات تجارية. بعد إثبات الملكية، يمكن إدارة المواقع الجغرافية للسلسلة المنشورة باستخدام واجهات برمجة تطبيقات الملف التجاري بالطريقة نفسها التي تتم بها إدارة المواقع الجغرافية الأخرى، مع بعض الاستثناءات. على سبيل المثال، يتم التعامل مع مديري المواقع بشكل مختلف، ويمكنهم إضافة أنفسهم إلى مواقع الامتيازات.

ما هي حدود الحصة لواجهات برمجة التطبيقات المتنوعة؟

تظهر حدود الحصص العادية في حدود الاستخدام. وإذا كنت بحاجة إلى حدود أعلى، يمكنك إرسال طلب حصة عادية.

ما هو مقدار الحصة التي يمكنني طلبها؟

الحصة هي مورد محدود. يحدِّد فريق دعم GBP API أهلية طلب زيادة الحصة من خلال تأكيد استخدامك السابق للحصة. إذا كان متوسط استخدام حصتك أقل من 70٪ من حدود حصتك الحالية، قد يتم منعك من أي زيادة أخرى في حدود حصتك.

هل يمكن لشركاء GBP API إنشاء حساب تجريبي للمنتجات؟

لا، ليس هناك طريقة مباشرة لإنشاء بيانات مزيفة لـ "الملف التجاري على Google" في المنتج، سواء من خلال واجهة المستخدم في "الملف التجاري على Google" أو واجهة برمجة التطبيقات واختبارها.

يتم الإبلاغ عن معظم البيانات الزائفة التي يتم إنشاؤها من قِبل الإشراف لدينا، كما يتم تعليقها. النصيحة هي إما استخدام بطاقة بيانات عميل والعمل عليها بعد ساعات (شرط ألا تغير أي معلومات أساسية في بطاقة البيانات، مثل الاسم والعنوان والفئة) أو أن تنشئ بطاقة بيانات لمقر شركتك الرئيسي. وإذا كنت تريد اختبار ردّ من واجهة برمجة التطبيقات للتحقّق من بطاقة بيانات أو أي إجراء آخر يتطلب بطاقة بيانات منتج، يمكنك استخدام ردود واجهة برمجة التطبيقات الوهمية.