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

Google Cloud Platform yüzlerce REST API'si sunar: mesajlaşma, depolama, kuyruklama, kimlik, haritalama, makine öğrenimi, üretkenlik (Calendar, Drive, Gmail, Docs), reklamcılık, analiz, faturalandırma ve daha fazlası. Şimdiye kadar bunları Delphi'den çağırmak, JWT imzalayıcıları, OAuth2 belirteç yenileyicileri, çok parçalı yükleyiciler ve SSE ayrıştırıcıları elle yazmak anlamına geliyordu. sgcWebSockets en yaygın yüzeyler için birinci sınıf bileşenler sunar: Firebase Cloud Messaging HTTP v1 için TsgcHTTP_API_GoogleFCM, Cloud Pub/Sub için TsgcHTTP_API_GoogleCloudPubSub, Calendar API v3 için TsgcHTTP_API_GoogleCalendar. Ayrıca diğer her Google uç noktasını yöneten yeniden kullanılabilir OAuth2 + hizmet-hesabı-JWT altyapısı ve uzun kuyruk için sgcOpenAPI kod üreteci.

Kimlik doğrulama tek tiptir: bir Google Cloud projesi, bir hizmet hesabı JSON anahtarı (veya son kullanıcı akışları için bir OAuth2 istemcisi) ve uygun https://www.googleapis.com/auth/... kapsamları. Kütüphanenin JWT imzalayıcısı onaylamayı oluşturur, oauth2.googleapis.com/token'dan bir erişim belirteci ister ve bunu şeffaf bir şekilde önbelleğe alır / yeniler. Aynı kod, hem VCL hem de FMX UI katmanlarıyla Windows, macOS, Linux, iOS ve Android üzerinde değiştirilmeden çalışır.

Çoğu Google Cloud API'si iki kimlik bilgisi biçimi kabul eder: bir hizmet hesabı JSON anahtarı (kullanıcı etkileşimi olmadan kısa ömürlü bir bearer belirteci için oauth2.googleapis.com/token'da değiş tokuş edilen RS256 imzalı JWT) ve son kullanıcı verileri (Calendar, Drive, Gmail) için standart yetkilendirme kodu veya cihaz kodu akışıyla bir OAuth2 istemcisi. sgcWebSockets her ikisini de kapsar: TsgcJWTClient onaylamayı imzalar, TsgcOAuth2Client kullanıcı akışını yönetir ve hizmet başına bileşenler hangi kimlik bilgisini bağlarsanız onu tüketir. Belirteçler bellekte önbelleğe alınır ve süresi dolmadan yenilenir, böylece uygulama kodunuz hiçbir zaman bir 401 ile karşılaşmaz.

Cloud Pub/Sub, Google'ın küresel olarak dağıtılmış, en az bir kez mesajlaşma dokusudur. Sayısız olay tabanlı mimarinin omurgasıdır. Aynı hizmet hesabı kimlik bilgisi her iki ucu da yönetir; yayıncılar bir konuya mesaj POST eder, aboneler ya bir programa göre çeker ya da bir HTTPS uç noktasında push teslimatlarını kabul eder.

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;