بيئة الخادم و"FCM"

يتألّف الجانب الخادمي من Firebase Cloud Messaging من مكوّنين:

  • خلفية FCM التي توفّرها Google
  • خادم التطبيق أو بيئة الخادم الموثوق بها الأخرى التي يتم فيها تنفيذ منطق الخادم، مثل Cloud Functions for Firebase أو بيئات السحابة الإلكترونية الأخرى التي تديرها Google

يُرسِل خادم التطبيق أو بيئة الخادم الموثوق به طلبات الرسائل إلى FCM الخلفية، التي تعيد توجيه الرسائل إلى تطبيقات العميل التي تعمل على أجهزة المستخدمين.

متطلبات بيئة الخادم الموثوق بها

يجب أن تستوفي بيئة خادم التطبيقات المعايير التالية:

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

اختيار خيار الخادم

عليك اختيار طريقة للتفاعل مع خوادم FCM: إما باستخدام Firebase Admin SDK أو البروتوكول الأوّلي. ونظرًا لتوفّره في لغات البرمجة الشائعة وطرقه المريحة في التعامل مع المصادقة والتفويض، فإنّ Firebase Admin SDK هي الطريقة المُقترَحة.

تشمل خيارات التفاعل مع خوادم FCM ما يلي:

Firebase Admin SDK لـ FCM

تتعامل واجهة برمجة التطبيقات Admin FCM API مع المصادقة مع الخلفية وتسهّل إرسال الرسائل وإدارة الاشتراكات في المواضيع. باستخدام Firebase Admin SDK، يمكنك إجراء ما يلي:

  • إرسال الرسائل إلى أجهزة فردية
  • إرسال الرسائل إلى المواضيع وبيانات الشروط التي تتطابق مع موضوع واحد أو أكثر
  • اشتراك الأجهزة في المواضيع وإلغاء اشتراكها منها
  • إنشاء أحمال الرسائل الأساسية حسب الأنظمة الأساسية المستهدَفة المختلفة

يوفّر حِزم تطوير البرامج (SDK) لنظام التشغيل Node.js للمشرفين methods لإرسال الرسائل إلى مجموعات الأجهزة.

لإعداد Firebase Admin SDK، يُرجى الاطّلاع على مقالة إضافة Firebase Admin SDK إلى خادمك. إذا كان لديك مشروع على Firebase، ابدأ بخطوة إضافة حزمة تطوير البرامج (SDK). احرص أيضًا على تفعيل Cloud Messaging API في صفحة إعدادات Cloud Messaging لمشروعك. بعد تثبيت Firebase Admin SDK، يمكنك البدء في كتابة منطق لمحاولة إنشاء طلبات الإرسال.

بروتوكول الخادم FCM

يوفّر FCM FCM HTTP v1 API للمطوّرين الذين يفضّلون استخدام بروتوكول خادم خام.

لإرسال رسالة، يصدر خادم التطبيق طلب POST مع عنوان HTTP ونص HTTP يتألف من أزواج قيم مفاتيح JSON. للحصول على تفاصيل حول خيارات العنوان والنص، يُرجى الاطّلاع على مقالة إنشاء طلبات إرسال خادم التطبيق.