بيئة الخادم والمراسلة عبر السحابة الإلكترونية من Firebase

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

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

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

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

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

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

بيانات الاعتماد المطلوبة لمشروع Firebase

استنادًا إلى ميزات FCM التي تستخدمها، قد تحتاج إلى بيانات الاعتماد التالية من مشروعك على Firebase:

بيانات الاعتماد الوصف
رقم تعريف المشروع معرّف فريد لمشروعك على Firebase، ويُستخدَم في الطلبات المُرسَلة إلى نقطة نهاية HTTP FCM الإصدار 1. تتوفّر هذه القيمة في لوحة Firebaseالإعدادات في وحدة التحكّم.
رمز التسجيل سلسلة رمز مميّز فريدة تحدّد كل مثيل من تطبيق العميل. يجب توفُّر رمز التسجيل لإرسال الرسائل إلى جهاز واحد أو مجموعة أجهزة. يُرجى العِلم أنّه يجب الحفاظ على سرية رموز التسجيل.
معرّف المُرسِل قيمة رقمية فريدة يتم إنشاؤها عند إنشاء مشروعك على Firebase، وهي متاحة في علامة التبويب Cloud Messaging ضمن لوحة Firebase في جزء الإعدادات. معرّف المرسِل هو نفسه رقم المشروع. يُستخدَم معرّف المرسِل لتحديد كل مرسِل يمكنه إرسال رسائل إلى تطبيق العميل.
رمز الدخول رمز مميز قصير الأمد لبروتوكول OAuth 2.0 يمنح الإذن بإرسال الطلبات إلى واجهة برمجة التطبيقات HTTP v1. يرتبط هذا الرمز المميز بحساب خدمة يخص مشروعك على Firebase. لإنشاء رموز الدخول وتغييرها، اتّبِع الخطوات الموضّحة في تفويض طلبات الإرسال.

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

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

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

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 الإصدار 1 API للمطوّرين الذين يفضّلون استخدام بروتوكول خادم أولي.

لإرسال رسالة، يرسل خادم التطبيق طلب POST مع عنوان HTTP ونص HTTP يتألف من أزواج قيم ومفاتيح JSON. للحصول على تفاصيل حول خيارات العنوان والنص، راجِع إرسال رسالة باستخدام واجهة برمجة التطبيقات FCM HTTP الإصدار 1.