迁移出设备组

设备组消息传递功能已废弃,将于 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 字段,然后发送请求。

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

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