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

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

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

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

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

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

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

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

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

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

• الإصدار Firebase Admin SDK الذي يتوافق مع Node وJava وPython وC#‎ وGo.
• FCM واجهة برمجة التطبيقات HTTP v1، وهي واجهة برمجة تطبيقات RESTful تتضمّن ميزة تفويض آمنة وإمكانات مراسلة مرنة على أنظمة تشغيل مختلفة (تستند Firebase Admin SDK إلى هذا البروتوكول وتوفّر جميع مزاياه المتأصّلة).

Firebase Admin SDK لـ FCM

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

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

يتيح Admin Node.js SDK طرقًا لإرسال الرسائل إلى مجموعات الأجهزة.

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

توفّر Firebase Admin SDK واجهة برمجة تطبيقات للاشتراك في مواضيع المراسلة عبر السحابة الإلكترونية من Firebase وإلغاء الاشتراك فيها على الأجهزة. يمكن أن تشترك هذه العمليات أو تلغي الاشتراك في ما يصل إلى 1,000 رمز مميّز لتسجيل الأجهزة في المرة الواحدة. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة المواضيع من الخادم.

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

توفّر FCM FCM واجهة برمجة التطبيقات HTTP الإصدار 1 للمطوّرين الذين يفضّلون استخدام بروتوكول خادم أولي.

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