المصادقة باستخدام واجهة برمجة تطبيقات الحجز في "خرائط Google"

لإجراء تعديلات في الوقت الفعلي، عليك تقديم طلبات إلى Maps Booking API. تتطلّب واجهة برمجة تطبيقات الحجز في "خرائط Google" أن تصادق طلباتك عبر OAuth 2.0 باستخدام حساب خدمة Google Cloud Platform الذي يمكنه الوصول إلى واجهة برمجة التطبيقات، وتم تخصيص QPS اللازمة. سيرشدك هذا الدليل خلال الخطوات التالية:

1. إعداد مشروعك على Google Cloud
2. إنشاء حساب خدمة
3. تفعيل واجهة برمجة تطبيقات حجز "خرائط Google" في مشروع Google Cloud Platform
4. تصحيح الأخطاء الشائعة

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

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

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

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

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

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

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

تفعيل واجهة برمجة التطبيقات MapsBooking

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

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

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

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

إذا واجهت أخطاء 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.

أما زلت ترى الأخطاء؟

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

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