تم إيقاف ميزة المراسلة لمجموعة الأجهزة نهائيًا، ولن تعمل بعد 29 سبتمبر 2027. تساعدك التعليمات في إيقاف الميزة.
إدارة عملية ربط الرموز المميزة بالمجموعات
بما أنّ خدمة FCM لن تخزّن مجموعات الأجهزة بعد الآن، عليك إنشاء خريطة خاصة بك والاحتفاظ بها بين مجموعاتك (مثل معرّف المستخدم) ورموز التسجيل المرتبطة بها في FCM على خادم تطبيقك. ننصحك باستخدام حل تخزين دائم، مثل Cloud Firestore أو قاعدة بيانات الوقت الفعلي أو قاعدة بيانات علائقية.
عندما يبدأ تشغيل تطبيق العميل أو يتم تجديد الرمز المميّز الخاص به، يجب الحصول على الرمز المميّز وإرساله إلى الخلفية لتخزينه. يربط الخلفية بعد ذلك الرمز المميز بالمستخدم أو المجموعة المناسبَين.
استرداد عملية الربط الحالية بين الرموز المميزة للمجموعات
توفّر واجهات برمجة التطبيقات لإدارة مجموعات الأجهزة في FCM طريقة GET
لاسترداد قائمة برموز التسجيل التي تنتمي إلى notification_key معيّن.
تحذير: سيتم إيقاف واجهة برمجة التطبيقات الخاصة باسترداد عملية الربط بين الرموز المميزة للمجموعات في 29 أيلول (سبتمبر) 2027، ولن يتم الاحتفاظ بالبيانات بعد ذلك. يمكنك استرداد بيانات مجموعتك قبل 29 سبتمبر 2027 إذا احتجت إلى ذلك.
إرسال رسائل إلى كل رمز مميّز في مجموعة
لإرسال رسالة إلى مجموعة باستخدام عمليات الربط التي تمّت إدارتها حديثًا بين الرموز المميزة والمجموعات، استرجِع قائمة الرموز المميزة من قاعدة البيانات.
إذا كنت تستخدم حزمة تطوير البرامج (SDK) للمشرف في Firebase، يمكنك استخدام واجهة برمجة التطبيقات الخاصة بالرسائل المتعددة البث (sendEachForMulticast) لإرسال حمولة رسالة واحدة إلى عدة رموز مميزة في الوقت نفسه.
إذا كنت تستدعي واجهة برمجة التطبيقات FCM HTTP v1 API مباشرةً، عليك إرسال طلب HTTP منفصل لكل رمز مميّز في مجموعتك، وذلك من خلال تكرار قائمة الرموز المميزة للتسجيل وإرسال طلب مع ضبط الحقل token بشكل صريح في حمولة الرسالة.
استخدام المراسلة حسب الموضوع لإرسال الرسائل إلى عدد كبير من الأجهزة
المراسلة حسب الموضوع ليست بديلاً مباشرًا للمراسلة الجماعية. تم تحسين المواضيع لتحقيق سرعة معالجة البيانات بدلاً من تقليل وقت الاستجابة، ويُنصح بها عند الحاجة إلى توزيع البيانات على نطاق واسع. يمكنك الاطّلاع على مزيد من المعلومات حول كيفية إدارة الاشتراكات في المواضيع وإرسال الرسائل إلى المواضيع إذا كانت هذه الميزة متاحة لك.