Google Cloud SDK dla Delphi — FCM, Pub/Sub, Calendar i więcej

Google Cloud Platform udostępnia setki REST API — komunikaty, storage, kolejkowanie, tożsamość, mapowanie, machine learning, produktywność (Calendar, Drive, Gmail, Docs), reklama, analityka, billing i więcej. Do tej pory wywoływanie ich z Delphi oznaczało ręczne pisanie signerów JWT, refresherów tokenów OAuth2, uploaderów multipart i parserów SSE. sgcWebSockets dostarcza komponenty pierwszej klasy dla najczęstszych powierzchni — TsgcHTTP_API_GoogleFCM dla Firebase Cloud Messaging HTTP v1, TsgcHTTP_API_GoogleCloudPubSub dla Cloud Pub/Sub, TsgcHTTP_API_GoogleCalendar dla Calendar API v3 — plus wielokrotnie używalną infrastrukturę OAuth2 + service-account-JWT, która napędza każdy inny endpoint Google, oraz generator kodu sgcOpenAPI dla długiego ogona.

Uwierzytelnianie jest jednolite: projekt Google Cloud, klucz JSON service account (lub klient OAuth2 dla przepływów użytkownika końcowego) i odpowiednie zakresy https://www.googleapis.com/auth/.... Signer JWT biblioteki buduje asercję, żąda tokenu dostępu z oauth2.googleapis.com/token i buforuje / odświeża go transparentnie. Ten sam kod działa bez modyfikacji na Windows, macOS, Linux, iOS i Android, zarówno z warstwami UI VCL, jak i FMX.

Większość API Google Cloud akceptuje dwie formy poświadczeń: klucz JSON service account (JWT podpisany RS256 wymieniany w oauth2.googleapis.com/token na krótkotrwały token bearer, bez interakcji użytkownika) oraz klient OAuth2 ze standardowym przepływem authorisation-code lub device-code dla danych użytkownika końcowego (Calendar, Drive, Gmail). sgcWebSockets pokrywa oba: TsgcJWTClient podpisuje asercję, TsgcOAuth2Client napędza przepływ użytkownika, a komponenty per-usługa konsumują dowolne poświadczenie, które podłączysz. Tokeny są buforowane w pamięci i odświeżane przed wygaśnięciem, więc kod Twojej aplikacji nigdy nie dotyka 401.

Cloud Pub/Sub to globalnie dystrybuowana, at-least-once tkanina komunikatów Google — kręgosłup niezliczonych architektur zorientowanych na zdarzenia. Te same poświadczenia service account napędzają oba końce; wydawcy POST-ują wiadomości do tematu, subskrybenci albo pobierają zgodnie z harmonogramem, albo akceptują push-deliveries na 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;