Firebase Cloud Messaging (TsgcHTTPGoogleCloud_FCM_Client) — sgcWebSockets

한눈에 보기

TsgcHTTPGoogleCloud_FCM_Client

FCM HTTP V1 클라이언트 — Google 서비스 계정 JSON을 로드하고 RS256 JWT에 서명한 다음, OAuth 액세스 토큰으로 교환하고 FCM 메시지를 fcm.googleapis.com/v1/projects/<id>/messages:send로 POST해요.

컴포넌트 클래스

TsgcHTTPGoogleCloud_FCM_Client

프로토콜

Firebase Cloud Messaging

플랫폼

Windows, macOS, Linux, iOS, Android

에디션

Standard / Professional / Enterprise

빠른 시작

서비스 계정 로드, 푸시 전송

Firebase 서비스 계정 JSON을 로드하고 프로젝트 ID를 설정한 다음, FCM 페이로드(token / topic / condition)와 함께 SendMessage를 호출하세요.

uses
  sgcHTTP;

var
  FCM: TsgcHTTPGoogleCloud_FCM_Client;
begin
  FCM := TsgcHTTPGoogleCloud_FCM_Client.Create(nil);
  FCM.GoogleCloudOptions.ServiceAccountJSON.LoadFromFile('service-account.json');

  FCM.SendMessage(
    'fcm-device-token-here',
    'Hello from Delphi',
    'This is a test FCM push');
end;

// uses: sgcHTTP
TsgcHTTPGoogleCloud_FCM_Client *FCM = new TsgcHTTPGoogleCloud_FCM_Client(this);
FCM->GoogleCloudOptions->ServiceAccountJSON->LoadFromFile("service-account.json");

FCM->SendMessage(
  "fcm-device-token-here",
  "Hello from Delphi",
  "This is a test FCM push");

기술 기능

내부 구성

FCM HTTP v1 엔드포인트를 대상으로 해요 — 레거시 fcm.googleapis.com/fcm/send 엔드포인트는 Google에 의해 폐기됐어요.

서비스 계정 인증

표준 Firebase 서비스 계정 JSON을 로드하고, 포함된 개인 키로 RS256 JWT에 서명한 다음, oauth2.googleapis.com/token에서 액세스 토큰으로 교환해요.

토큰 / 토픽 / 조건으로 전송

SendMessage 오버로드는 등록 토큰, 토픽 이름(/topics/news) 또는 토픽 조건 식을 받아요. SendBroadcast는 팬아웃을 위해 토픽을 대상으로 해요.

알림 + 데이터 페이로드

notification 객체(title/body/image)와 자유 형식 data 딕셔너리가 모두 노출되며, 플랫폼별 재정의(Android android, iOS apns, Web webpush)도 포함돼요.

토큰 캐싱

액세스 토큰은 캐시되고 만료된 경우에만 갱신되므로 대용량 발신자가 OAuth 엔드포인트를 과부하시키지 않아요.

HTTP 전송

프로젝트의 표준 HTTP 클라이언트를 사용해요 — 다른 HTTP 요청처럼 프록시, TLS 설정, 속도 제한기와 함께 사용하세요.

오류 타입화

OnSendError는 HTTP 및 FCM 관련 오류(미등록 토큰, 잘못된 인수, 할당량 초과)를 보고하므로 죽은 토큰을 정리하거나 백오프할 수 있어요.

표준

사양 & 참고 자료

이 컴포넌트가 구현하는 API의 공식 출처.

리소스

문서 & 데모

컴포넌트 레퍼런스로 바로 이동하고, 바로 실행 가능한 데모 프로젝트를 가져오고, 체험판을 다운로드해요.

	온라인 도움말 — FCM Client Full property, method and event reference for this component.	열기
	데모 프로젝트 — Demos\20.HTTP_Protocol\03.Google 바로 실행 가능한 예제 프로젝트. sgcWebSockets 패키지에 포함되어 있어요 — 아래에서 체험판을 다운로드하세요.	열기
	기술 문서 (PDF) 이 컴포넌트만의 기능, 빠른 시작, Delphi & C++ Builder 코드 샘플과 1차 출처 참고 자료.	열기
	사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서.	열기

Firebase Cloud Messaging (FCM)