Firebase Admin SDK, FCM 토픽 구독 API v1 전환…legacy 호출 폐기 예정

핵심 요약

Firebase가 2026년 9월 23일 Admin Node.js SDK 14.5.0, Admin Go SDK 4.22.0, Admin Python SDK 7.7.0을 공개했습니다. 세 SDK 모두 기존 토픽 구독·해제 API를 legacy Instance ID API에서 Cloud Messaging v1 topic subscription API로 전환했습니다. 기존 메서드·함수 이름은 유지되지만 실제 호출 경로가 v1으로 바뀝니다.

주요 변경

• Node.js의 subscribeToTopic()·unsubscribeFromTopic(), Go의 SubscribeToTopic()·UnsubscribeFromTopic(), Python의 subscribe_to_topic()·unsubscribe_from_topic()이 Cloud Messaging v1 토픽 구독 API를 사용합니다.
• 각 SDK에는 기존 Instance ID API를 계속 호출하는 Legacy 계열 API가 별도로 추가됐지만, 공식적으로 deprecated 상태이며 향후 릴리스에서 제거될 예정입니다.
• Python 7.7.0은 App Check replay protection을 사용할 때 app_check.verify_token()이 v1 대신 v1beta 엔드포인트를 사용하도록 변경됐습니다.

개발자 영향

일반적인 토픽 구독 코드는 기존 메서드 이름을 그대로 사용할 수 있지만, 업데이트 후에는 Cloud Messaging v1 경로를 사용합니다. 레거시 Instance ID 동작이 필요한 경우 임시로 새 Legacy API를 사용할 수 있으나 이미 폐기 예정이므로 장기 의존은 피해야 합니다.

발표 시각(KST): 2026년 9월 23일 · 세부 시각 미공개

원문 출처 보기 →