يتألف جزء Firebase Cloud Messaging من الخادم من مكوّنَين:
- FCM الخلفية التي توفّرها Google
- خادم التطبيق أو أي بيئة خادم موثوقة أخرى يتم فيها تنفيذ منطق الخادم، مثل Cloud Functions for Firebase أو بيئات السحابة الإلكترونية الأخرى التي تديرها Google
يرسل خادم تطبيقك أو بيئة الخادم الموثوق به طلبات الرسائل إلى الخلفية FCM، التي توجّه الرسائل بعد ذلك إلى تطبيقات العميل التي تعمل على أجهزة المستخدمين.
باستخدام بروتوكولات خادم التطبيق Firebase Admin SDK أو FCM، يمكنك إنشاء طلبات رسائل وإرسالها إلى الأنواع التالية من الاستهدافات:
- اسم الموضوع
- الشرط
- رمز التسجيل FCM
- اسم مجموعة الأجهزة (سيتم إيقافها نهائيًا وإزالتها في 29 سبتمبر 2027)
يمكنك إرسال رسائل تتضمّن حمولة إشعار تتكوّن من حقول محدّدة مسبقًا، أو حمولة بيانات تتضمّن حقولاً محدّدة من قِبل المستخدم، أو رسالة تتضمّن كلا النوعين من الحمولة. يمكنك الاطّلاع على أنواع الرسائل لمزيد من المعلومات.
متطلبات بيئة الخادم الموثوق به
يجب أن يستوفي بيئة خادم تطبيقك المعايير التالية:
- أن يكون بإمكانك إرسال طلبات رسائل منسَّقة بشكل صحيح إلى FCM الخادم الخلفي.
- القدرة على معالجة الطلبات وإعادة إرسالها باستخدام التراجع الدليلي
- القدرة على تخزين بيانات اعتماد تفويض الخادم ورموز التسجيل الخاصة بالعميل بشكل آمن
بيانات الاعتماد المطلوبة لمشروع Firebase
استنادًا إلى ميزات FCM التي تنفّذها، قد تحتاج إلى بيانات الاعتماد التالية من مشروعك على Firebase:
| بيانات الاعتماد | الوصف |
|---|---|
| رقم تعريف المشروع | معرّف فريد لمشروع Firebase، ويُستخدَم في الطلبات الموجّهة إلى نقطة نهاية HTTP FCM الإصدار 1. تتوفّر هذه القيمة في لوحة 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). عليك أيضًا التأكّد من تفعيل واجهة برمجة التطبيقات لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" (الإصدار 1) في صفحة إعدادات خدمة "المراسلة عبر السحابة الإلكترونية" لمشروعك. بعد تثبيت Firebase Admin SDK، يمكنك البدء في كتابة منطق إنشاء طلبات الإرسال.
FCM واجهة برمجة التطبيقات HTTP v1
توفّر FCM FCM HTTP v1 API للمطوّرين الذين يفضّلون استخدام بروتوكول خادم أولي.
لإرسال رسالة، يرسل خادم التطبيق طلب POST مع عنوان HTTP ونص HTTP يتألف من أزواج قيم ومفاتيح JSON. للاطّلاع على تفاصيل حول خيارات العنوان والنص، راجِع إرسال رسالة باستخدام واجهة برمجة التطبيقات FCM HTTP الإصدار 1.