设备组消息功能已弃用,将于 2027 年 9 月 29 日之后停止运行。这些说明可帮助您停用该功能。
管理您自己的群组令牌映射
由于 FCM 将不再存储您的设备组,因此您必须在应用服务器上构建并维护您自己的群组(例如用户 ID)与其关联的 FCM 注册令牌之间的映射。我们建议使用持久性存储解决方案,例如 Cloud Firestore、Realtime Database 或关系型数据库。
当客户端应用启动或其令牌刷新时,应捕获令牌并将其发送到您的后端以进行存储。然后,您的后端会将该令牌与相应的用户或群组相关联。
检索您现有的群组-令牌映射
FCM 设备组管理 API 提供了一个 GET 方法,用于检索属于给定 notification_key 的注册令牌列表。
警告:用于检索群组令牌映射的 API 将于 2027 年 9 月 29 日停用,之后数据将不再保留。如果您需要,请在 2027 年 9 月 29 日之前检索群组数据。
向群组中的每个令牌发送消息
如需使用新管理的群组令牌映射向群组发送消息,请从数据库中检索令牌列表。
如果您使用的是 Firebase Admin SDK,则可以使用多播消息传递 API (sendEachForMulticast) 一次向多个令牌发送单个消息载荷。
如果您直接调用 FCM HTTP v1 API,则必须为群组中的每个令牌单独发出 HTTP 请求,遍历注册令牌列表,并在消息载荷中明确设置 token 字段,然后发送请求。
使用主题消息传递实现大规模扇出
主题消息传递并非群组消息传递的直接替代方案。主题的优化重心是吞吐量而非延迟,建议用于大扇出。您可以详细了解如何管理主题订阅和向主题发送消息(如果适合您)。