Google Cloud Pub/Sub (TsgcHTTPGoogleCloud_PubSub_Client) — sgcWebSockets

한눈에 보기

TsgcHTTPGoogleCloud_PubSub_Client

Google Cloud Pub/Sub REST 클라이언트 — 타입화된 Delphi 컴포넌트에서 토픽 생성, 메시지 게시, 구독에서 가져오기, ack 또는 ack 데드라인 변경을 수행해요.

컴포넌트 클래스

TsgcHTTPGoogleCloud_PubSub_Client

프로토콜

Pub/Sub REST API

플랫폼

Windows, macOS, Linux, iOS, Android

에디션

Standard / Professional / Enterprise

빠른 시작

서비스 계정 로드, 게시, 가져오기

서비스 계정 JSON을 로드하고 프로젝트 ID를 설정한 다음, 메시지 전송에는 Publish, 구독에서 소비하려면 Pull을 호출하세요.

uses
  sgcHTTP;

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

  // publish
  PubSub.Publish('projects/your-project/topics/topic-id',
    '{"event":"order_created","id":42}');

  // pull
  Memo1.Text := PubSub.Pull('projects/your-project/subscriptions/sub-id', 10);
end;

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

PubSub->Publish("projects/p/topics/t", payload);
Memo1->Text = PubSub->Pull("projects/p/subscriptions/s", 10);

기술 기능

내부 구성

표준 Google 서비스 계정 인증 흐름으로 Pub/Sub REST 인터페이스를 감싸요.

토픽 관리

CreateTopic, DeleteTopic, GetTopic, ListTopics가 /projects/<id>/topics 엔드포인트 계열에 접근해요.

게시

Publish는 선택적 속성과 정렬 키를 가진 하나 이상의 PubsubMessage 항목을 전송하고, 할당된 messageIds를 반환해요.

가져오기 / 확인

Pull(subscription, maxMessages)는 수신된 메시지를 ackId와 함께 반환해요. Acknowledge(subscription, ackIds)가 이를 완료하고, ModifyAckDeadline이 처리 시간을 연장해요.

서비스 계정 JWT

FCM 및 Calendar 동급 컴포넌트와 동일한 인증 흐름 — JSON 키 로드, RS256 JWT 서명, OAuth 토큰 교환, 필요 시 갱신을 수행해요.

구독 관리

CreateSubscription, DeleteSubscription, UpdateSubscription, ListSubscriptions가 Pub/Sub의 구독 측을 관리해요.

Push 또는 Pull

Pull 구독은 Pull로 읽어요. Push 구독은 엔드포인트를 호출하도록 구성되며 — 일반적으로 공개 URL 뒤의 TsgcWebSocketHTTPServer 인스턴스예요.

표준

사양 & 참고 자료

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

리소스

문서 & 데모

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

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

Google Cloud Pub/Sub