انتقال از «گروه‌های دستگاه»

ویژگی پیام گروهی دستگاه منسوخ شده است و پس‌از ۲۹ سپتامبر ۲۰۲۷ کار نخواهد کرد. دستورالعمل‌ها به شما کمک می‌کند از این ویژگی مهاجرت کنید.

مدیریت نگاشت گروه-نشان خودتان

ازآنجایی‌که FCM دیگر گروه‌های دستگاه شما را ذخیره نمی‌کند، باید نگاشت خودتان را بین گروه‌هایتان (مثل شناسه کاربر) و نشان‌های ثبت FCM مرتبط با آن‌ها در سرور برنامه‌تان بسازید و نگهداری کنید. توصیه می‌کنیم از راه‌حل ذخیره‌سازی ماندگار، مثل Cloud Firestore، پایگاه داده بی‌درنگ، یا پایگاه داده رابطه‌ای استفاده کنید.

وقتی برنامه مشتری شروع می‌شود یا نشان آن بازآوری می‌شود، باید نشان را ضبط کند و آن را برای ذخیره شدن به زیرینه شما ارسال کند. سپس زیرینه شما آن رمز را با کاربر یا گروه مناسب مرتبط می‌کند.

بازیابی کردن نگاشت گروه-نشان موجود

‫FCM device group management APIs یک روش GET برای بازیابی فهرست کد ثبت‌نامی که متعلق به notification_key است ارائه می‌دهد.

هشدار: API برای بازیابی نگاشت گروه-نشان در تاریخ ۲۹ سپتامبر ۲۰۲۷ غیرفعال خواهد شد و داده‌ها پس‌از آن نگهداری نخواهند شد. درصورت نیاز، داده‌های گروهتان را قبل‌از ۲۹ سپتامبر ۲۰۲۷ بازیابی کنید.

ارسال پیام به هریک از نشان‌های گروه

برای ارسال پیام به گروه بااستفاده از نگاشت‌های گروه-نشان مدیریت‌شده جدیدتان، فهرست نشان‌ها را از پایگاه داده‌تان بازیابی کنید.

اگر از Firebase Admin SDK استفاده می‌کنید، می‌توانید از API پیام‌رسانی چندپخشی (sendEachForMulticast) برای ارسال یک محتوای پیام به چندین کد در یک زمان استفاده کنید.

اگر مستقیماً FCM HTTP v1 API را فرا می‌خوانید، باید برای هر کد در گروهتان درخواست HTTP جداگانه‌ای ایجاد کنید، فهرست کدهای ثبت را تکرار کنید، و در محتوای پیام، در فیلد token درخواست ارسال کنید.

استفاده از پیام‌رسانی موضوعی برای توزیع گسترده

پیام‌رسانی موضوعی جایگزین مستقیم پیام‌رسانی گروهی نیست. موضوع‌ها برای توان عملیاتی بهینه‌سازی شده‌اند نه برای تأخیر، و برای توزیع گسترده توصیه می‌شوند. می‌توانید درباره نحوه مدیریت اشتراک‌های موضوعی و ارسال پیام به موضوعات اگر برای شما کار می‌کند بیشتر بدانید.