بيئة الخادم و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 API، وهي واجهة برمجة تطبيقات REST API تتضمّن تفويضًا آمنًا و إمكانات مرنة للرسائل على جميع المنصات (تستند Firebase Admin SDK إلى هذا البروتوكول وتوفر كل مزاياه الأساسية).

Firebase Admin SDK لـ FCM

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

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

يوفّر حِزم تطوير البرامج (SDK) لنظام التشغيل Node.js للمشرفين methods لإرسال الرسائل إلى مجموعات الأجهزة.

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

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