المصادقة باستخدام Mapsbooking API

لإجراء تعديلات في الوقت الفعلي، عليك إرسال طلبات إلى Maps Booking API. يتطلب Maps Booking API مصادقة طلباتك عبر OAuth 2.0 باستخدام حساب خدمة على Google Cloud Platform (GCP) يمكنه الوصول إلى واجهة برمجة التطبيقات وتم تخصيص عدد طلبات كافٍ له في الثانية. سيرشدك هذا الدليل خلال الخطوات التالية:

1. إعداد مشروعك على Google Cloud
2. إنشاء حساب خدمة
3. تفعيل Maps Booking API في مشروعك على Google Cloud Platform
4. تحديد المشاكل الشائعة وحلّها

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

إعداد مشروعك على Google Cloud باستخدام "مركز الإجراءات"

ملاحظة: إذا سبق لك إعداد حسابك على "بوابة الشريك"، عليك استخدام مشروع Google Cloud الذي تم إدخاله كجزء من عملية الإعداد. إذا لم يعُد بإمكانك الوصول إلى مشروع Google Cloud Platform هذا أو كنت بحاجة إلى مساعدة في تحديده، يُرجى التواصل مع جهة الاتصال في "مركز الإجراءات".

1. سجِّل الدخول إلى حسابك على Google Cloud Platform.
2. يمكنك إنشاء مشروع جديد أو استخدام مشروع حالي لهذا الغرض.
   • يُرجى تدوين رقم مشروع على السحابة الإلكترونية لأنّك ستحتاج إليه في الخطوات التالية. يمكنك أيضًا العثور على رقم مشروع السحابة الإلكترونية في الصفحة الرئيسية على Google Cloud Platform. يتضمّن رقم مشروع على السحابة الإلكترونية أرقامًا فقط.
3. سجِّل الدخول إلى "بوابة الشريك".
4. أكمِل الخطوة 1 في صفحة مهام الإعداد في "بوابة الشريك" من خلال إرسال رقم مشروع السحابة الإلكترونية وعنوان البريد الإلكتروني لمشروع السحابة الإلكترونية (عنوان البريد الإلكتروني المُستخدَم لإدارة مشروع السحابة الإلكترونية).

إنشاء حساب خدمة وبيانات اعتماد OAuth

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

1. سجِّل الدخول مرة أخرى إلى حسابك على Google Cloud Platform.
2. انتقِل إلى "إدارة الهوية وإمكانية الوصول والمشرف" > "حسابات الخدمة".
3. ابحث عن رقم تعريف مشروعك على السحابة الإلكترونية الحالي أو الذي تم إنشاؤه حديثًا.
4. أنشئ حساب خدمة.
5. املأ تفاصيل حساب الخدمة.
6. امنح حساب الخدمة الجديد الدور الأنسب لاحتياجات تطبيقك. لن يؤثر اختيار الدور لحساب الخدمة في الطلبات التي يمكن إرسالها إلى Google Maps Booking API، لأنّ تخصيص الحصة الكافية لاستخدامها يتم بدلاً من ذلك من خلال ربط رقم مشروعك في إعدادات "مركز الإجراءات". إذا لم تكن متأكدًا من الدور الذي يجب اختياره، ما عليك سوى اختيار "المشروع" > "مُشاهد".
7. بعد النقر على "متابعة" في الخطوة (6)، سيظهر لك خيار إنشاء مفاتيح JSON.
8. احفظ بيانات اعتماد JSON. احرص على تخزينها في مكان آمن، لأنّه لن يكون بإمكانك استردادها في وقت لاحق.
9. سجِّل الدخول مرة أخرى إلى "بوابة الشريك" وأكمِل المهام المتبقية في صفحة مهام الإعداد في "بوابة الشريك".

تفعيل MapsBooking API

1. سجِّل الدخول إلى حسابك على Google Cloud Platform.
2. انتقِل إلى "واجهات برمجة التطبيقات والخدمات > لوحة البيانات".
3. انقر على تفعيل واجهات برمجة التطبيقات والخدمات وابحث عن Google Maps Booking API.
4. فعِّل واجهات برمجة التطبيقات التالية:
   • Google Maps Booking API
   • Google Maps Booking API (الإصدار التجريبي)

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

الأخطاء الشائعة

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

إذا ظهرت لك أخطاء 403، تأكَّد من استيفاء جميع المتطلبات التالية:

1. استخدِم إحدى مكتبات عملاء Google.
2. أنشِئ بيانات اعتماد OAuth باستخدام مصادقة حساب الخدمة.
3. فوِّض الوصول إلى النطاق المناسب.
4. أرسِل الطلبات إلى نقطة النهاية المناسبة (المدرَجة أدناه).

تأكَّد من إرسال الطلبات إلى نقطة النهاية الصحيحة:

1. وضع الحماية: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
2. بيئة الإنتاج: https://mapsbooking.googleapis.com/v1alpha/...

تأكَّد من تفويض طلبات بيانات اعتماد OAuth بشكلٍ صحيح:

1. أنت تفوِّض الوصول إلى النطاق "https://www.googleapis.com/auth/mapsbooking".
2. أنت تستخدم مفتاح حساب الخدمة الذي تم إنشاؤه في إنشاء حساب خدمة وبيانات اعتماد OAuth.

هل لا تزال تظهر لك أخطاء؟

إذا استمر ظهور الأخطاء بعد اتّباع هذه الخطوات، يُرجى التواصل مع جهة الاتصال في "مركز الإجراءات" مع تقديم المعلومات التالية:

• رقم مشروع على السحابة الإلكترونية ورقم تعريف المشروع مع لقطة شاشة
• رقم تعريف حساب الخدمة
• عنوان البريد الإلكتروني المُستخدَم لإنشاء حساب الخدمة
• تفاصيل نقطة النهاية التي حاولت إرسال الطلبات إليها
• وقت محاولات إرسال الطلبات
• الطلب الكامل ورسائل الخطأ التي تم تلقّيها عند إرسال الطلبات