Google Cloud Pub/Sub クライアント (TsgcHTTPGoogleCloud_PubSub_Client) — sgcWebSockets

概要

TsgcHTTPGoogleCloud_PubSub_Client

Google Cloud Pub/Sub REST クライアントです。型付き Delphi コンポーネントから、トピックの作成、メッセージのパブリッシュ、サブスクリプションからのプル、確認応答または確認応答期限の変更ができます。

コンポーネントクラス

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 は、オプションの属性と順序付きキーを持つ 1 つ以上の PubsubMessage エントリを送信し、割り当てられた messageIds を返します。

プル / 確認応答

Pull(subscription, maxMessages) は ackId とともに受信したメッセージを返します。Acknowledge(subscription, ackIds) でメッセージを確定し、ModifyAckDeadline で処理時間を延長できます。

サービスアカウント JWT

FCM および Calendar コンポーネントと同じ認証フローです。JSON キーを読み込み、RS256 JWT に署名し、OAuth トークンと交換して、必要に応じてリフレッシュします。

サブスクリプション管理

CreateSubscription、DeleteSubscription、UpdateSubscription、ListSubscriptions が Pub/Sub のサブスクリプション側を管理します。

プッシュまたはプル

プルサブスクリプションは Pull で読み取ります。プッシュサブスクリプションは、通常はパブリック URL 配下の TsgcWebSocketHTTPServer インスタンスであるエンドポイントを呼び出すように設定します。

標準規格

仕様・参考資料

このコンポーネントが実装する API の公式ソースです。

リソース

ドキュメント・デモ

コンポーネントリファレンスへの直接リンク、すぐに実行できるデモプロジェクトの入手、体験版のダウンロードができます。

	オンラインヘルプ — Google Pub/Sub クライアントこのコンポーネントのプロパティ、メソッド、イベントの完全なリファレンスです。	開く
	デモプロジェクト — Demos\20.HTTP_Protocol\03.Google すぐに実行できるサンプルプロジェクトです。sgcWebSockets パッケージに同梱されています。以下から体験版をダウンロードできます。	開く
	技術ドキュメント (PDF) このコンポーネントの機能、クイックスタート、Delphi および C++ Builder 向けのコードサンプル、一次資料のリファレンスを掲載しています。	開く
	ユーザーマニュアル (PDF) ライブラリのすべてのコンポーネントを網羅した総合マニュアルです。	開く

Google Cloud Pub/Sub