從裝置群組遷移

裝置群組訊息功能已淘汰,並將於 2027 年 9 月 29 日後停止運作。按照操作說明遷移出這項功能。

管理自己的群組權杖對應

由於 FCM 不再儲存裝置群組,您必須在應用程式伺服器上,自行建立及維護群組 (例如使用者 ID) 與相關聯 FCM 註冊權杖之間的對應關係。建議使用永久儲存空間解決方案,例如 Cloud Firestore、即時資料庫或關聯式資料庫。

當用戶端應用程式啟動或權杖重新整理時,應擷取權杖並傳送至後端儲存。後端會將該權杖與適當的使用者或群組建立關聯。

擷取現有的群組權杖對應

FCM 裝置群組管理 API 提供 GET 方法,可擷取屬於特定 notification_key 的註冊權杖清單。

警告:擷取群組權杖對應的 API 將於 2027 年 9 月 29 日停用,之後系統不會保留相關資料。如需群組資料,請在 2027 年 9 月 29 日前擷取。

將訊息傳送至群組的每個權杖

如要使用新管理群組權杖對應將訊息傳送至群組,請從資料庫擷取權杖清單。

如果您使用 Firebase Admin SDK,可以透過多播訊息 API (sendEachForMulticast) 一次將單一訊息酬載傳送至多個權杖。

如果您直接呼叫 FCM HTTP v1 API,則必須為群組中的每個權杖發出個別的 HTTP 要求,並逐一檢查註冊權杖清單,然後在訊息酬載中明確設定 token 欄位,藉此傳送要求。

使用主題訊息傳送大量擴散傳遞

主題訊息並非群組訊息的直接替代方案。主題的設計著重於輸送量而非延遲時間,因此建議用於大型扇出。如果這項功能適用於您,請進一步瞭解如何管理主題訂閱項目和將訊息傳送至主題。