قابلیت پیامرسانی گروهی دستگاه منسوخ شده است و پس از ۲۹ سپتامبر ۲۰۲۷ از کار خواهد افتاد. دستورالعملها به شما کمک میکنند تا از این قابلیت خارج شوید.
مدیریت نگاشت توکنهای گروهی خودتان
از آنجا که FCM دیگر گروههای دستگاه شما را ذخیره نمیکند، باید نگاشت خود را بین گروههای خود (مانند شناسه کاربری) و توکنهای ثبت FCM مرتبط با آنها در سرور برنامه خود ایجاد و نگهداری کنید. توصیه میکنیم از یک راهکار ذخیرهسازی پایدار مانند Cloud Firestore، Realtime Database یا یک پایگاه داده رابطهای استفاده کنید.
وقتی یک برنامه کلاینت شروع به کار میکند یا توکن آن بهروزرسانی میشود، باید توکن را دریافت کرده و برای ذخیره به بکاند شما ارسال کند. سپس بکاند شما آن توکن را با کاربر یا گروه مناسب مرتبط میکند.
نگاشت توکنهای گروهی موجود خود را بازیابی کنید
APIهای مدیریت گروه دستگاههای FCM یک روش GET برای بازیابی لیست توکنهای ثبت نام که متعلق به یک notification_key مشخص هستند، ارائه میدهند.
هشدار: API مربوط به بازیابی نگاشت توکنهای گروه در تاریخ ۲۹ سپتامبر ۲۰۲۷ غیرفعال خواهد شد و دادهها پس از آن حفظ نخواهند شد. در صورت نیاز، دادههای گروه خود را قبل از ۲۹ سپتامبر ۲۰۲۷ بازیابی کنید.
ارسال پیام به هر توکن از یک گروه
برای ارسال پیام به یک گروه با استفاده از نگاشتهای توکنهای گروهی که به تازگی مدیریت کردهاید، لیست توکنها را از پایگاه داده خود بازیابی کنید.
اگر از Firebase Admin SDK استفاده میکنید، میتوانید از API پیامرسانی چندپخشی ( sendEachForMulticast ) برای ارسال همزمان یک پیام به چندین توکن استفاده کنید.
اگر مستقیماً API مربوط به FCM HTTP نسخه ۱ را فراخوانی میکنید، باید برای هر توکن در گروه خود یک درخواست HTTP جداگانه ایجاد کنید، لیست توکنهای ثبتنام را مرور کنید و درخواستی را با فیلد token به صراحت در payload پیام تنظیم شده است، ارسال کنید.
از پیامرسانی موضوعی برای خروجیهای بزرگ استفاده کنید
پیامرسانی موضوعی جایگزین مستقیمی برای پیامرسانی گروهی نیست. موضوعات برای افزایش سرعت و نه تأخیر بهینه شدهاند و برای تعداد زیادی از مشترکین توصیه میشوند. در صورت تمایل میتوانید در مورد نحوه مدیریت اشتراکهای موضوعی و ارسال پیام به موضوعات اطلاعات بیشتری کسب کنید.