迁移出设备组

设备组消息功能已弃用,并将于 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 字段的请求。

使用主题消息传递功能进行大规模扇出

主题消息传递不能直接替代群组消息传递。主题的优化重心是吞吐量而非延迟,建议用于大型扇出。您可以详细了解如何管理主题订阅以及如何向主题发送消息(如果适合您)。