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