SDK Google Cloud Delphi — FCM, Pub/Sub, Calendar e altro

Google Cloud Platform espone centinaia di API REST — messaging, storage, code, identity, mapping, machine learning, produttività (Calendar, Drive, Gmail, Docs), advertising, analytics, billing e altro. Finora, chiamarle da Delphi voleva dire scrivere a mano signer JWT, refresher di token OAuth2, uploader multipart e parser SSE. sgcWebSockets distribuisce componenti di prima classe per le superfici più comuni — TsgcHTTP_API_GoogleFCM per Firebase Cloud Messaging HTTP v1, TsgcHTTP_API_GoogleCloudPubSub per Cloud Pub/Sub, TsgcHTTP_API_GoogleCalendar per la Calendar API v3 — più infrastruttura riutilizzabile OAuth2 + JWT di service account che pilota ogni altro endpoint Google, e il generatore di codice sgcOpenAPI per la lunga coda.

L'autenticazione è uniforme: un progetto Google Cloud, una chiave JSON di service account (o un client OAuth2 per i flussi end-user), e gli scope https://www.googleapis.com/auth/... appropriati. Il signer JWT della libreria costruisce l'assertion, richiede un access token a oauth2.googleapis.com/token e lo memorizza / rinfresca in modo trasparente. Lo stesso codice gira senza modifiche su Windows, macOS, Linux, iOS e Android, con layer UI VCL e FMX.

La maggior parte delle API Google Cloud accetta due forme di credenziale: una chiave JSON di service account (JWT firmato RS256 scambiato su oauth2.googleapis.com/token con un bearer token a breve scadenza, senza interazione utente) e un client OAuth2 con il classico flusso authorization-code o device-code per dati end-user (Calendar, Drive, Gmail). sgcWebSockets copre entrambi: TsgcJWTClient firma l'assertion, TsgcOAuth2Client pilota il flusso utente, e i componenti per servizio consumano qualunque credenziale colleghi. I token vengono memorizzati in memoria e rinfrescati prima della scadenza, così il codice della tua applicazione non incontra mai un 401.

Cloud Pub/Sub è il tessuto di messaging at-least-once distribuito globalmente di Google — la spina dorsale di innumerevoli architetture event-driven. La stessa credenziale di service account pilota entrambi i lati; i publisher fanno POST di messaggi a un topic, i subscriber o fanno pull a intervalli o accettano consegne push su 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;