기기 그룹 메시지 기능은 지원 중단되었으며 2027년 9월 29일 이후에는 작동이 중지됩니다. 이 안내는 기능에서 이전하는 데 도움이 됩니다.
자체 그룹 토큰 매핑 관리
FCM은 더 이상 기기 그룹을 저장하지 않으므로 앱 서버에서 그룹 (예: 사용자 ID)과 연결된 FCM 등록 토큰 간의 매핑을 직접 빌드하고 유지관리해야 합니다. Cloud Firestore, 실시간 데이터베이스 또는 관계형 데이터베이스와 같은 영구 스토리지 솔루션을 사용하는 것이 좋습니다.
클라이언트 앱이 시작되거나 토큰이 새로고침되면 토큰을 캡처하여 저장할 백엔드로 전송해야 합니다. 그러면 백엔드에서 해당 토큰을 적절한 사용자 또는 그룹과 연결합니다.
기존 그룹-토큰 매핑 가져오기
FCM 기기 그룹 관리 API는 지정된 notification_key에 속하는 등록 토큰 목록을 가져오는 GET 메서드를 제공합니다.
경고: 그룹-토큰 매핑을 검색하는 API는 2027년 9월 29일에 지원 중단되며 이후에는 데이터가 보관되지 않습니다. 필요한 경우 2027년 9월 29일 전에 그룹 데이터를 검색하세요.
그룹의 각 토큰에 메시지 전송
새로 관리되는 그룹-토큰 매핑을 사용하여 그룹에 메시지를 보내려면 데이터베이스에서 토큰 목록을 검색합니다.
Firebase Admin SDK를 사용하는 경우 멀티캐스트 메시징 API(sendEachForMulticast)를 사용하여 단일 메시지 페이로드를 한 번에 여러 토큰으로 전송할 수 있습니다.
FCM HTTP v1 API를 직접 호출하는 경우 그룹의 각 토큰에 대해 별도의 HTTP 요청을 수행하고 등록 토큰 목록을 반복하며 메시지 페이로드에 token 필드가 명시적으로 설정된 요청을 전송해야 합니다.
대규모 팬아웃에 주제 메시지 사용
주제 메시징은 그룹 메시징을 직접 대체하지 않습니다. 주제는 지연 시간이 아닌 처리량을 위주로 최적화되며 대규모 팬아웃에 권장됩니다. 주제 구독을 관리하고 주제에 메시지를 전송하는 방법을 자세히 알아보세요.