بيئة الخادم و"FCM"
يتألف جانب الخادم من Firebase Cloud Messaging من مكوّنَين:
- خلفية FCM التي توفّرها Google
- خادم التطبيق أو بيئة خادم موثوق بها أخرى حيث لتشغيل منطق الخادم، مثل وظائف السحابة الإلكترونية لبرنامج Firebase أو بيئات السحابة الإلكترونية الأخرى مُدارة بواسطة Google.
يُرسِل خادم التطبيق أو بيئة الخادم الموثوق بها طلبات الرسائل إلى FCM الخلفية التي توجّه الرسائل إلى تطبيقات العميل التي تعمل على حسابات الأجهزة.
متطلبات بيئة الخادم الموثوق بها
يجب أن تستوفي بيئة خادم التطبيق المعايير التالية:
- قادر على إرسال طلبات الرسائل المنسَّقة بشكل صحيح إلى واجهة FCM الخلفية.
- قادر على معالجة الطلبات وإعادة إرسالها باستخدام تراجع أسّي
- قادر على تخزين بيانات اعتماد تفويض الخادم ورموز تسجيل العميل بأمان.
تحديد أحد خيارات الخادم
عليك اختيار طريقة للتفاعل مع خوادم FCM إما باستخدام Firebase Admin SDK أو البروتوكول الأولي. ونظرًا لدعمها عبر لغات البرمجة الشائعة وطرق ملاءمتها التعامل مع المصادقة والتفويض، فإن Firebase Admin SDK هي الطريقة الموصى بها.
تشمل خيارات التفاعل مع خوادم FCM ما يلي:
- Firebase Admin SDK، الذي يدعم عقدة، Java، Python، C#، أو انتقال
- صفحة FCM HTTP v1 API، وهي واجهة برمجة تطبيقات REST ذات تفويض آمن ومرن. إمكانات المراسلة من عدّة منصات (تستند Firebase Admin SDK إلى هذا البروتوكول جميع مزاياها الكامنة).
Firebase Admin SDK لـ FCM
تتعامل واجهة برمجة تطبيقات Admin FCM API مع المصادقة مع الخلفية وتسهِّل الإرسال الرسائل وإدارة الاشتراكات في المواضيع باستخدام Firebase Admin SDK، يمكنك إجراء ما يلي:
- إرسال رسائل إلى أجهزة فردية
- يمكنك إرسال رسائل إلى المواضيع وعبارات الشرط التي تتطابق مع موضوع واحد أو أكثر.
- اشتراك الأجهزة في المواضيع وإلغاء الاشتراك فيها
- إنشاء حمولات بيانات الرسائل مخصَّصة ليناسب الأنظمة الأساسية المستهدَفة المختلفة
توفّر حزمة تطوير البرامج (SDK) الخاصة بالمشرف في Node.js طُرق لإرسال الرسائل إلى مجموعات الأجهزة.
لإعداد "Firebase Admin SDK"، راجِع إضافة Firebase Admin SDK إلى خادمك. إذا كان لديك مشروع على Firebase من قبل، عليك البدء من خلال إضافة حزمة تطوير البرامج (SDK). تأكد أيضًا من تمكين Cloud Messaging API في صفحة إعدادات خدمة "المراسلة عبر السحابة الإلكترونية" لمشروعك. بعد ذلك، بمجرد تثبيت Firebase Admin SDK، يمكنك البدء في كتابة المنطق إنشاء طلبات الإرسال
بروتوكول الخادم FCM
توفّر السمة FCM السمة FCM HTTP v1 API للمطوّرين الذين يفضّلون بروتوكول خادم غير آلي
لإرسال رسالة، يصدر خادم التطبيق طلب POST مع عنوان HTTP ونص HTTP يتألف من أزواج قيم مفاتيح JSON. للحصول على تفاصيل حول خيارات العنوان والنص، يُرجى الاطّلاع على طلب إرسال طلبات إلى خادم إنشاء تطبيق