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

Google Cloud Platform biedt honderden REST-API’s — messaging, storage, queueing, identity, mapping, machine learning, productiviteit (Calendar, Drive, Gmail, Docs), advertising, analytics, billing en meer. Tot nu toe betekende ze aanroepen vanuit Delphi handmatig JWT-signers, OAuth2 token-refreshers, multipart-uploaders en SSE-parsers schrijven. sgcWebSockets levert first-class componenten voor de meest voorkomende oppervlakken — TsgcHTTP_API_GoogleFCM voor Firebase Cloud Messaging HTTP v1, TsgcHTTP_API_GoogleCloudPubSub voor Cloud Pub/Sub, TsgcHTTP_API_GoogleCalendar voor de Calendar API v3 — plus herbruikbare OAuth2- + service-account-JWT-infrastructuur die elke andere Google-endpoint aanstuurt, en de sgcOpenAPI-codegenerator voor de long tail.

Authenticatie is uniform: een Google Cloud-project, een service-account JSON-key (of een OAuth2-client voor eindgebruikersflows) en de juiste https://www.googleapis.com/auth/...-scopes. De JWT-signer van de library bouwt de assertion, vraagt een access token op bij oauth2.googleapis.com/token en cached / refresht het transparant. Dezelfde code draait ongewijzigd op Windows, macOS, Linux, iOS en Android, met zowel VCL- als FMX-UI-lagen.

De meeste Google Cloud-API’s accepteren twee vormen van credential: een service-account JSON-key (RS256-ondertekende JWT die op oauth2.googleapis.com/token wordt geruild voor een kortlevende bearer-token, zonder gebruikersinteractie) en een OAuth2-client met de standaard authorisation-code- of device-code-flow voor eindgebruikersdata (Calendar, Drive, Gmail). sgcWebSockets dekt beide: TsgcJWTClient ondertekent de assertion, TsgcOAuth2Client stuurt de gebruikersflow, en de per-service-componenten gebruiken het credential dat je inhangt. Tokens worden in-memory gecached en vóór het verlopen ververst, zodat je applicatiecode nooit een 401 raakt.

Cloud Pub/Sub is Google’s wereldwijd gedistribueerde, at-least-once messaging-laag — de ruggengraat van talloze event-driven architecturen. Hetzelfde service-account credential stuurt beide kanten aan; publishers POSTen berichten naar een topic, subscribers pullen op een planning of accepteren push-deliveries op een HTTPS-endpoint.

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;