SDK Google Cloud para Delphi — FCM, Pub/Sub, Calendar & mais

A Google Cloud Platform expõe centenas de APIs REST — messaging, storage, filas, identidade, mapeamento, machine learning, produtividade (Calendar, Drive, Gmail, Docs), publicidade, analytics, billing e mais. Até agora, chamá-las a partir do Delphi significava escrever à mão signers JWT, refresh de tokens OAuth2, uploaders multipart e parsers SSE. O sgcWebSockets entrega componentes de primeira classe para as superfícies mais comuns — TsgcHTTP_API_GoogleFCM para Firebase Cloud Messaging HTTP v1, TsgcHTTP_API_GoogleCloudPubSub para Cloud Pub/Sub, TsgcHTTP_API_GoogleCalendar para a Calendar API v3 — mais infraestrutura reutilizável de OAuth2 + JWT de service account que dirige todo outro endpoint Google, e o gerador de código sgcOpenAPI para a cauda longa.

A autenticação é uniforme: um projeto Google Cloud, uma chave JSON de service account (ou um cliente OAuth2 para fluxos de usuário final) e os escopos https://www.googleapis.com/auth/... apropriados. O signer JWT da biblioteca monta a assertion, pede um access token em oauth2.googleapis.com/token e faz cache / refresh transparentemente. O mesmo código roda inalterado em Windows, macOS, Linux, iOS e Android, em camadas de UI VCL e FMX.

A maioria das APIs do Google Cloud aceita duas formas de credencial: uma chave JSON de service account (JWT assinado em RS256 trocado em oauth2.googleapis.com/token por um bearer token de curta duração, sem interação do usuário) e um cliente OAuth2 com o fluxo padrão authorization-code ou device-code para dados do usuário final (Calendar, Drive, Gmail). O sgcWebSockets cobre ambos: TsgcJWTClient assina a assertion, TsgcOAuth2Client dirige o fluxo do usuário, e os componentes por serviço consomem a credencial que você conectar. Tokens são cacheados em memória e renovados antes da expiração, então seu código de aplicação nunca encara um 401.

O Cloud Pub/Sub é a malha de mensageria at-least-once globalmente distribuída do Google — a espinha dorsal de incontáveis arquiteturas event-driven. A mesma credencial de service account dirige ambos os lados; publishers fazem POST em um tópico, subscribers ou puxam em um schedule ou aceitam entregas push em um 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;