SDK Google Cloud para Delphi — FCM, Pub/Sub, Calendar y más

Google Cloud Platform expone cientos de APIs REST — mensajería, almacenamiento, colas, identidad, mapas, machine learning, productividad (Calendar, Drive, Gmail, Docs), publicidad, analítica, facturación y más. Hasta ahora, llamarlas desde Delphi suponía escribir a mano firmadores JWT, refrescadores de token OAuth2, uploaders multipart y parsers SSE. sgcWebSockets incluye componentes de primera para las superficies más comunes — TsgcHTTP_API_GoogleFCM para Firebase Cloud Messaging HTTP v1, TsgcHTTP_API_GoogleCloudPubSub para Cloud Pub/Sub, TsgcHTTP_API_GoogleCalendar para Calendar API v3 — además de infraestructura reutilizable de OAuth2 + JWT de service account que controla cualquier otro endpoint de Google y el generador de código sgcOpenAPI para la larga cola.

La autenticación es uniforme: un proyecto de Google Cloud, una clave JSON de service account (o un cliente OAuth2 para flujos de usuario final), y los scopes https://www.googleapis.com/auth/... apropiados. El firmador JWT de la librería construye la aserción, solicita un access token a oauth2.googleapis.com/token y lo cachea / refresca de forma transparente. El mismo código corre sin modificaciones en Windows, macOS, Linux, iOS y Android, con interfaces VCL y FMX.

La mayoría de las APIs de Google Cloud aceptan dos formas de credencial: una clave JSON de service account (JWT firmado RS256 intercambiado en oauth2.googleapis.com/token por un bearer token de corta vida, sin interacción del usuario) y un cliente OAuth2 con el flujo estándar de authorization-code o device-code para datos de usuario final (Calendar, Drive, Gmail). sgcWebSockets cubre ambos: TsgcJWTClient firma la aserción, TsgcOAuth2Client controla el flujo de usuario, y los componentes por servicio consumen la credencial que conectes. Los tokens se cachean en memoria y se refrescan antes de expirar, de modo que tu código de aplicación nunca toca un 401.

Cloud Pub/Sub es la fábrica de mensajería at-least-once globalmente distribuida de Google — la espina dorsal de innumerables arquitecturas event-driven. La misma credencial de service account controla ambos extremos; los publicadores hacen POST de mensajes a un topic, los suscriptores o bien hacen pull en un horario o bien aceptan entregas push en un endpoint 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;