Delphi Google Cloud SDK — FCM、Pub/Sub、Calendar その他

Google Cloud Platform は数百の REST API — メッセージング、ストレージ、キューイング、ID、マッピング、機械学習、生産性（Calendar、Drive、Gmail、Docs）、広告、分析、課金など — を公開しています。これまで Delphi からの呼び出しは、JWT 署名者、OAuth2 トークンリフレッシャー、マルチパートアップローダー、SSE パーサーを手書きすることを意味しました。sgcWebSockets は最も一般的な面に対する第一級コンポーネントを出荷します — Firebase Cloud Messaging HTTP v1 用の TsgcHTTP_API_GoogleFCM、Cloud Pub/Sub 用の TsgcHTTP_API_GoogleCloudPubSub、Calendar API v3 用の TsgcHTTP_API_GoogleCalendar — 加えて、他のすべての Google エンドポイントを駆動する再利用可能な OAuth2 + サービスアカウント JWT インフラと、ロングテール用の sgcOpenAPI コードジェネレーター。

認証は統一されています: Google Cloud プロジェクト、サービスアカウント JSON キー（またはエンドユーザーフロー用の OAuth2 クライアント）、適切な https://www.googleapis.com/auth/... スコープ。ライブラリの JWT 署名者はアサーションを構築し、oauth2.googleapis.com/token からアクセストークンを要求し、透過的にキャッシュ／更新します。同じコードが変更なしで Windows、macOS、Linux、iOS、Android で、VCL と FMX UI 層の両方で動作します。

ほとんどの Google Cloud API は 2 つの形式の資格情報を受け入れます: サービスアカウント JSON キー（oauth2.googleapis.com/token で短寿命ベアラートークンと交換される RS256 署名 JWT、ユーザー操作なし）と、エンドユーザーデータ（Calendar、Drive、Gmail）用の標準的な認証コードまたはデバイスコードフロー付き OAuth2 クライアント。sgcWebSockets は両方をカバーします: TsgcJWTClient がアサーションに署名し、TsgcOAuth2Client がユーザーフローを駆動し、サービスごとのコンポーネントが結線した資格情報を消費します。トークンはメモリにキャッシュされ、期限前に更新されるため、アプリケーションコードは 401 に触れません。

Cloud Pub/Sub は Google のグローバル分散、at-least-once メッセージングファブリック — 無数のイベント駆動アーキテクチャのバックボーンです。同じサービスアカウント資格情報が両端を駆動します。発行者はトピックにメッセージを POST し、購読者はスケジュールでプルするか HTTPS エンドポイント上のプッシュ配信を受け入れます。

uses
  sgcHTTP_API_GoogleCloudPubSub;

var
  vPubSub: TsgcHTTP_API_GoogleCloudPubSub;
begin
  vPubSub := TsgcHTTP_API_GoogleCloudPubSub.Create(nil);
  try
    vPubSub.ProjectId          := 'my-project';
    vPubSub.ServiceAccountFile := 'C:\keys\my-project-pubsub.json';

    // Publish
    vPubSub.Publish('orders', '{"orderId":1234,"total":42.50}');

    // Pull
    vPubSub.OnMessageReceived := DoMessageReceived;
    vPubSub.Subscribe('orders-worker');  // long-running pull loop
  finally
    vPubSub.Free;
  end;
end;