بعد تطوير منطق في تطبيقك لتلقّي الرسائل، يمكنك السماح للمستخدمين غير الفنيين بإرسال الرسائل باستخدام أداة إنشاء الإشعارات.
لمحة عامة
عند إرسال رسالة إشعار من
أداة إنشاء الإشعارات،
تستخدم Google القيم التي تُدخلها في حقول النموذج بالطرق التالية:
تحدّد حقول مثل شريحة المستخدمين وتاريخ انتهاء الصلاحية خيارات استهداف الرسائل وتسليمها.
يتم إرسال الحقول، مثل نص الإشعار والبيانات المخصّصة، إلى العميل في حمولة تتألف من أزواج المفاتيح والقيم.
يتم ربط هذه الحقول بالمفاتيح المتاحة من خلال العنصر
Message. على سبيل المثال، يتم التعامل مع أزواج المفاتيح والقيم التي يتم إدخالها في حقل البيانات المخصّصة الخاص بالملحّن على أنّها حمولة data للإشعار. يتم ربط الحقول الأخرى مباشرةً بالمفاتيح في كائن notification أو في إعدادات الإشعارات الخاصة بالمنصة.
يُرجى العِلم أنّ بعض الحقول في
أداة إنشاء الإشعاراتغير متاحة من خلال واجهة برمجة التطبيقات FCM. على سبيل المثال، يمكنك استهداف شرائح المستخدمين استنادًا إلى إصدار التطبيق أو اللغة أو نوع المتصفّح وإصداره أو خصائص المستخدمين بطرق غير متاحة باستخدام واجهة برمجة التطبيقات للخادم.
المفاتيح التي ترسلها وحدة تحكّم Firebase إلى العملاء هي:
المفتاح
تصنيف حقل وحدة التحكّم
الوصف
notification.title
عنوان الإشعار
تشير هذه السمة إلى عنوان الإشعار.
notification.body
نص الإشعار
تشير إلى نص الإشعار.
data
البيانات المخصّصة
أزواج المفتاح/القيمة التي تحدّدها ويتم تسليمها كحمولة بيانات ليتعامل معها التطبيق.
تشمل المفاتيح التي تحدّد تسليم الرسائل ما يلي:
المفتاح
تصنيف حقل وحدة التحكّم
الوصف
sound
الصوت
يشير إلى صوت يتم تشغيله عندما يتلقّى الجهاز إشعارًا.
time_to_live
تاريخ انتهاء الصلاحية
تحدّد هذه المَعلمة المدة (بالثواني) التي يجب الاحتفاظ فيها بالرسالة في مساحة تخزين FCM
إذا كان الجهاز غير متصل بالإنترنت.
لمزيد من المعلومات، يُرجى الاطّلاع على تحديد مدة بقاء الرسالة.
تاريخ التعديل الأخير: 2025-08-16 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-16 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["You can send notification messages using\n[the Notifications composer](//console.firebase.google.com/project/_/notification) in the Firebase console. Though this does not\nprovide the same flexibility or scalability as sending messages with the\n[Admin SDK](/docs/cloud-messaging/admin) or the\n[v1 HTTP protocol](/docs/reference/fcm/rest), it can be\nvery useful for testing or for highly targeted marketing and user engagement.\nThe Firebase console provides analytics-based\n[A/B testing](/docs/ab-testing/abtest-with-console) to help refine and\nimprove marketing messages.\n\nAfter you have developed logic in your app to receive messages, you can allow\nnon-technical users to send messages with\n[the Notifications composer](//console.firebase.google.com/project/_/notification).\n\nAbout\n\nWhen you send a notification message from\n[the Notifications composer](//console.firebase.google.com/project/_/notification),\nGoogle uses the values you enter in the form fields in these ways:\n\n- Fields like **User segment** and **Expires** determine the message target and delivery options.\n- Fields like **Notification text** and **Custom data** are sent to the client in a payload comprised of key/value pairs.\n\nThese fields map to keys available through the\n[`Message`](/docs/reference/fcm/rest/v1/projects.messages#resource:-message)\nobject. For example, key/value pairs entered in the **Custom data**\nfield of the composer are handled as a\n[`data`](/docs/reference/fcm/rest/v1/projects.messages#Message.FIELDS.data)\npayload for the notification. Other fields map directly to keys in the\n[`notification`](/docs/reference/fcm/rest/v1/projects.messages#notification)\nobject or in the platform specific notification configuration.\n\nNote that some fields in\n[the Notifications composer](//console.firebase.google.com/project/_/notification) are *not* available through\nthe FCM API. For example, you can target user segments\nbased on app version, language, browser type and version, or user properties\nin ways that are not available using the server API.\n| **Caution:** In another important difference from programmatic messaging, the console lets you cancel any scheduled message that is not already in progress. **Once\n| a message fanout is actually in progress, it is fully committed and\n| cannot be canceled through the console nor by Firebase support.**\n\nThe keys that the Firebase console sends to clients are:\n\n| Key | Console field label | Description |\n|----------------------|---------------------|-----------------------------------------------------------------------------------------------|\n| `notification.title` | Notification title | Indicates notification title. |\n| `notification.body` | Notification text | Indicates notification body text. |\n| `data` | Custom data | Key/value pairs that you define. These are delivered as a data payload for the app to handle. |\n\nKeys that determine message delivery include:\n\n| Key | Console field label | Description |\n|----------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `sound` | Sound | Indicates a sound to play when the device receives a notification. |\n| `time_to_live` | Expires | This parameter specifies how long (in seconds) the message should be kept in FCM storage if the device is offline. For more information, see [Setting the lifespan of a message](/docs/cloud-messaging/concept-options#ttl). |"]]
