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

يتألف الجانب من جهة الخادم في Firebase Cloud Messaging من مكوّنَين:

  • الخادم الخلفي الذي توفّره GoogleFCM
  • خادم التطبيق أو بيئة خادم موثوق بها أخرى يتم فيها تشغيل منطق الخادم، مثل وظائف Firebase السحابية أو بيئات سحابية أخرى تديرها Google.

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

باستخدام بروتوكولات خادم التطبيق Firebase Admin SDK أو FCM، يمكنك إنشاء طلبات الرسائل وإرسالها إلى أنواع الأهداف التالية:

  • اسم الموضوع
  • الشرط
  • رمز تسجيل FCM
  • اسم مجموعة الأجهزة (البروتوكول فقط)

يمكنك إرسال رسائل تتضمّن حمولة إشعار تتألف من حقول محدّدة مسبقًا، أو حمولة بيانات تتألف من حقول محدّدة من قِبل المستخدم، أو رسالة تحتوي على كلا النوعَين من الحمولة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة أنواع الرسائل.

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

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

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

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

بناءً على ميزات FCM التي تنفّذها، قد تحتاج إلى بيانات الاعتماد التالية من مشروع Firebase:

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

FCM HTTP v1 API

FCM توفّر FCM واجهة HTTP v1 API للمطوّرين الذين يفضّلون استخدام بروتوكول خادم غير مُعدَّل.

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