إنشاء طلبات من خادم التطبيق لإنشاء طلبات

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

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

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

ملاحظة مهمة: يجب أن تتضمّن الطلبات المرسَلة لكل من Firebase Admin SDK وبروتوكول HTTP الإصدار 1 رقم تعريف مشروع Firebase الخاص بتطبيقك، والذي يتوفّر في علامة التبويب إعدادات المشروع العامة في وحدة تحكّم Firebase. تتطلّب كلتا طريقتَي إرسال الرسائل منك تفويض طلبات الإرسال.

توضّح الأمثلة الواردة في هذه الصفحة كيفية إرسال رسائل الإشعارات باستخدام Firebase Admin SDK (الذي يتوافق مع Node و Java و Python و C#‎ و Go) و بروتوكول HTTP الإصدار 1.

إرسال رسائل مفعَّلة لوضع "التشغيل المباشر" (على أجهزة Android فقط)

يمكنك إرسال رسائل إلى الأجهزة في وضع "التشغيل المباشر" باستخدام واجهات برمجة التطبيقات HTTP v1 أو HTTP القديمة. قبل الإرسال إلى الأجهزة في وضع التشغيل المباشر، تأكَّد من إكمال الخطوات اللازمة لإتاحة تلقّي الأجهزة العميلة لرسائل FCM في وضع التشغيل المباشر.

تنبيه: من المهم مراعاة إمكانية رؤية الرسائل المفعَّلة في وضع "التشغيل المباشر"، إذ يمكن لأي مستخدم لديه إذن الوصول إلى الجهاز الاطّلاع على هذه الرسائل بدون إدخال بيانات اعتماد المستخدم.

الإرسال باستخدام الإصدار 1 من واجهة برمجة التطبيقات HTTP للمراسلة عبر السحابة الإلكترونية من Firebase

يجب أن يتضمّن طلب الرسالة المفتاح "direct_boot_ok" : true في خيارات AndroidConfig لنص الطلب. على سبيل المثال:

https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send
Content-Type:application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
  "message":{
    "token" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
    "data": {
      "score": "5x1",
      "time": "15:10"
    },
    "android": {
      "direct_boot_ok": true,
    },
}