بيئة الخادم و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. لمعرفة التفاصيل حول خيارات الرأس والنص، يُرجى الاطّلاع على إنشاء طلبات إرسال خادم التطبيقات.