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

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

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

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

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

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

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

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

ارسال پیام به هریک از کدهای گروه

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

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

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

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

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