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

Google Cloud Platform expose des centaines d'API REST — messaging, stockage, queueing, identité, mapping, machine learning, productivité (Calendar, Drive, Gmail, Docs), publicité, analytics, facturation et bien plus. Jusqu'ici, les appeler depuis Delphi signifiait écrire à la main des signers JWT, des refreshers de token OAuth2, des uploaders multipart et des parseurs SSE. sgcWebSockets livre des composants de première classe pour les surfaces les plus courantes — TsgcHTTP_API_GoogleFCM pour Firebase Cloud Messaging HTTP v1, TsgcHTTP_API_GoogleCloudPubSub pour Cloud Pub/Sub, TsgcHTTP_API_GoogleCalendar pour la Calendar API v3 — plus une infrastructure réutilisable OAuth2 + JWT de compte de service qui pilote tous les autres endpoints Google, et le générateur de code sgcOpenAPI pour la longue traîne.

L'authentification est uniforme : un projet Google Cloud, une clé JSON de compte de service (ou un client OAuth2 pour les flux end-user) et les scopes https://www.googleapis.com/auth/... appropriés. Le signer JWT de la bibliothèque construit l'assertion, demande un access token à oauth2.googleapis.com/token et le met en cache / le rafraîchit de manière transparente. Le même code tourne sans modification sur Windows, macOS, Linux, iOS et Android, avec des couches UI VCL et FMX.

La plupart des API Google Cloud acceptent deux formes de credential : une clé JSON de compte de service (JWT signé RS256 échangé sur oauth2.googleapis.com/token contre un bearer token éphémère, sans interaction utilisateur) et un client OAuth2 avec le flux standard authorization-code ou device-code pour les données end-user (Calendar, Drive, Gmail). sgcWebSockets couvre les deux : TsgcJWTClient signe l'assertion, TsgcOAuth2Client pilote le flux utilisateur, et les composants par service consomment le credential que vous branchez. Les tokens sont mis en cache en mémoire et rafraîchis avant expiration, de sorte que votre code applicatif ne rencontre jamais un 401.

Cloud Pub/Sub est le tissu de messaging au moins une fois mondialement distribué de Google — la colonne vertébrale d'innombrables architectures event-driven. Le même credential de compte de service pilote les deux extrémités ; les publishers POSTent des messages vers un topic, les subscribers tirent sur un planning ou acceptent des livraisons push sur 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;