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

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

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

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

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

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

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

هل يتيح الوصول إلى واجهات برمجة تطبيقات "الملف التجاري على 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
• واجهة برمجة التطبيقات Lodging API في "نشاطي التجاري على Google"
• My Business Place Actions API
• My Business Notifications API
• My Business Verifications API
• My Business Business Information API
• My Business Q&A API
• Business Profile Performance API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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