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

ما هي واجهات برمجة تطبيقات GBP؟

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

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

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

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

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

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

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

ما هي السياسات ذات الصلة لمستخدمي واجهة برمجة التطبيقات GBP API؟

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

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

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

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

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

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

• الإصدار 4.9 من واجهة برمجة تطبيقات "نشاطي التجاري على Google"، الذي يتضمّن طلبات البيانات المهمة التالية من واجهة برمجة التطبيقات:
  • FoodMenus
  • Media
  • Reviews
  • LocalPosts
• My Business Account Management API
• واجهة برمجة تطبيقات خدمة الإقامة في "نشاطي التجاري على Google"
• واجهة برمجة تطبيقات إجراءات الأماكن في نشاطي التجاري
• My Business Notifications API
• My Business Verifications API
• My Business Business Information API
• My Business Q&A API
• واجهة برمجة تطبيقات أداء الملف التجاري

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

كيف يتم الوصول إلى واجهة برمجة التطبيقات GBP API؟

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

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

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

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

إذا كان لا يزال لديك أسئلة حول البيانات المتاحة لك و / أو كيفية الوصول إلى البيانات، استخدِم النماذج التالية لتقديم طلب:

• الإنجليزية
• الألمانية
• الهولندية
• الإيطالية
• الإسبانية
• الفرنسية

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

إذا كنت شريكًا خارجيًا يدير بيانات الأنشطة التجارية:

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

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

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

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

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

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

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

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

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

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

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

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

هل يمكن لشركاء واجهة برمجة التطبيقات GBP API إنشاء حساب تجريبي للإصدار العلني؟

لا، لا تتوفّر طريقة مباشرة لإنشاء بطاقة بيانات GBP مزيّفة في مرحلة الإنتاج سواء من خلال واجهة مستخدم GBP أو واجهة برمجة التطبيقات واختبارها.

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