기기 그룹 메시지 기능은 지원 중단되었으며 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를 직접 호출하는 경우 등록 토큰 목록을 반복하고 메시지 페이로드에 token 필드가 명시적으로 설정된 요청을 전송하여 그룹의 각 토큰에 대해 별도의 HTTP 요청을 해야 합니다.
대규모 팬아웃에 주제 메시지 사용
주제 메시지는 그룹 메시지를 직접 대체하지 않습니다. 주제는 지연 시간보다는 처리량에 최적화되어 있으며 대규모 팬아웃에 권장됩니다. 주제 구독을 관리하고 주제에 메시지를 전송하는 방법을 자세히 알아보세요.