لإجراء تعديلات في الوقت الفعلي، عليك تقديم طلبات إلى Maps Booking API. تتطلّب واجهة برمجة تطبيقات حجز الخرائط مصادقة طلباتك عبر OAuth 2.0 باستخدام حساب خدمة Google Cloud Platform الذي يمكنه الوصول إلى واجهة برمجة التطبيقات، وتم تخصيص طلبات عدد الطلبات في الثانية اللازمة. سيرشدك هذا الدليل خلال الخطوات التالية من أجل:
- إعداد مشروعك على Google Cloud
- إنشاء حساب خدمة
- تفعيل Maps Booking API في مشروعك على Google Cloud Platform
- تصحيح الأخطاء الشائعة
للحصول على معلومات عن كيفية إجراء طلبات واجهة برمجة التطبيقات، يُرجى الاطّلاع على قسم تعديلات واجهة برمجة التطبيقات في الوقت الفعلي ضِمن دليل الحجوزات الشامل.
إعداد مشروعك على Google Cloud باستخدام "مركز الإجراءات"
- سجِّل الدخول إلى حسابك على Google Cloud Platform.
- يمكنك
إنشاء مشروع جديد أو استخدام مشروع حالي لهذا الغرض.
- يُرجى تدوين رقم المشروع على السحابة الإلكترونية بما أنّك ستحتاج إليه في
الخطوات التالية. يمكن أيضًا العثور على رقم مشروعك على السحابة الإلكترونية في صفحة Google
Cloud Platform الرئيسية. يكون رقم المشروع على السحابة الإلكترونية دائمًا رقميًا
فقط.
- يُرجى تدوين رقم المشروع على السحابة الإلكترونية بما أنّك ستحتاج إليه في
الخطوات التالية. يمكن أيضًا العثور على رقم مشروعك على السحابة الإلكترونية في صفحة Google
Cloud Platform الرئيسية. يكون رقم المشروع على السحابة الإلكترونية دائمًا رقميًا
فقط.
- سجِّل الدخول إلى بوابة الشريك.
- أكمِل الخطوة 1 في صفحة "مهام الإعداد" ضمن "بوابة الشريك" من خلال
إرسال رقم المشروع على السحابة الإلكترونية وعنوان البريد الإلكتروني الخاص بالمشروع على السحابة الإلكترونية
(عنوان البريد الإلكتروني الذي يتم استخدامه لإدارة المشروع على السحابة الإلكترونية).
إنشاء حساب خدمة وبيانات اعتماد OAuth
- سجِّل الدخول مرة أخرى إلى حسابك على Google Cloud Platform.
- انتقِل إلى
إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.
- ابحث عن رقم تعريف مشروعك الحالي أو الذي تم إنشاؤه حديثًا على السحابة الإلكترونية.
- أنشئ حساب خدمة.
- املأ تفاصيل حساب الخدمة.
- عيّن الدور الأكثر ملاءمة لاحتياجات تطبيقك لحساب الخدمة الجديد. لن يكون لاختيار دور حساب الخدمة أي تأثير على الطلبات التي يمكن إجراؤها إلى Google Maps Booking API، لأنّ تخصيص الحصة الكافية لاستخدامها يتم تحديده بدلاً من ذلك من خلال ربط رقم مشروعك في إعدادات "مركز الإجراءات". إذا لم تكن متأكدًا من الدور الذي يجب اختياره، فما عليك سوى اختيار "المشروع" > "مُشاهد".
- بعد النقر على "متابعة" في الخطوة (6)، سيتوفّر لك خيار إنشاء مفاتيح JSON.
- احفظ بيانات اعتماد تنسيق json. يُرجى الحرص على حفظ هذه الصور في مكان آمن، لأنّ
لن تتمكن من استردادها في وقت لاحق.
- سجِّل الدخول مرة أخرى إلى "بوابة الشريك" وأكمِل المهام المتبقية في صفحة مهام الإعداد على "بوابة الشريك".
تفعيل MapsBooking API
- سجِّل الدخول إلى حسابك على Google Cloud Platform.
- انتقِل إلى واجهة برمجة التطبيقات والخدمات > لوحة البيانات.
- انقر على تفعيل واجهات برمجة التطبيقات والخدمات وابحث عن
Google Maps Booking API.
- فعِّل واجهات برمجة التطبيقات التالية:
- Google Maps Booking API
- واجهة برمجة تطبيقات الحجز في خرائط Google (إصدار مطوّري البرامج)
الأخطاء الشائعة
هناك عدة أسباب قد تجعلك تواجه مشاكل متعلقة بالتفويض عند إجراء طلبات تحديث في الوقت الفعلي. إذا كنت بحاجة إلى إرشادات عامة حول كيفية إجراء طلبات الحصول على التعديلات في الوقت الفعلي، راجِع قسم تعديلات واجهة برمجة التطبيقات في الوقت الفعلي ضمن الدليل الشامل للحجوزات. يمكنك أيضًا العثور على نماذج برامج بلغات متعددة في القسم نماذج الرموز.
إذا ظهرت أخطاء 403، تأكَّد من استيفاء جميع المتطلبات التالية:
- استخدِم مكتبة برامج Google.
- أنشئ بيانات اعتماد OAuth باستخدام مصادقة حساب الخدمة.
- التفويض وفقًا للنطاق المناسب.
- إجراء استدعاءات إلى نقطة النهاية المناسبة (المُدرَجة أدناه).
تأكَّد من إجراء استدعاءات إلى نقطة النهاية الصحيحة:
- وضع الحماية:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - الإنتاج:
https://mapsbooking.googleapis.com/v1alpha/...
تأكَّد من تفويض طلبات بيانات اعتماد OAuth بشكلٍ صحيح:
- يتم منح التفويض اللازم للنطاق "https://www.googleapis.com/auth/mapsbooking".
- أنت تستخدم مفتاح حساب الخدمة الذي تم إنشاؤه في إنشاء حساب خدمة وبيانات اعتماد OAuth.
هل ما زالت تظهر لك الأخطاء؟
إذا استمرّت الأخطاء بعد اتّباع هذه الخطوات، تواصَل مع جهة الاتصال في "مركز الإجراءات" واذكر المعلومات التالية:
- رقم المشروع على السحابة الإلكترونية ورقم تعريف المشروع مع لقطة شاشة
- رقم تعريف حساب الخدمة
- البريد الإلكتروني المُستخدَم لإنشاء حساب الخدمة
- حاولت تفاصيل نقطة النهاية تقديم طلبات إلى
- وقت محاولات الطلب
- الطلب الكامل ورسائل الخطأ التي تم تلقّيها عند تقديم الطلبات