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