Google Cloud Pub/Sub

从 Delphi 发布和拉取 Google Cloud Pub/Sub 主题中的消息。服务账号 JWT 签名以及类型化的 Publish / Pull / Acknowledge 方法。

TsgcHTTPGoogleCloud_PubSub_Client

Google Cloud Pub/Sub REST 客户端 — 从类型化的 Delphi 组件创建主题、发布消息、从订阅拉取、确认或修改确认截止时间。

组件类

TsgcHTTPGoogleCloud_PubSub_Client

平台

Windows, macOS, Linux, iOS, Android

版本

Standard / Professional / Enterprise

加载服务账号,发布,拉取

加载服务账号 JSON,设置项目 ID,然后调用 Publish 发送消息,Pull 从订阅中消费。

uses
  sgcHTTP;

var
  PubSub: TsgcHTTPGoogleCloud_PubSub_Client;
begin
  PubSub := TsgcHTTPGoogleCloud_PubSub_Client.Create(nil);
  PubSub.GoogleCloudOptions.ServiceAccountJSON.LoadFromFile('service-account.json');

  // publish
  PubSub.Publish('projects/your-project/topics/topic-id',
    '{"event":"order_created","id":42}');

  // pull
  Memo1.Text := PubSub.Pull('projects/your-project/subscriptions/sub-id', 10);
end;
// uses: sgcHTTP
TsgcHTTPGoogleCloud_PubSub_Client *PubSub = new TsgcHTTPGoogleCloud_PubSub_Client(this);
PubSub->GoogleCloudOptions->ServiceAccountJSON->LoadFromFile("service-account.json");

PubSub->Publish("projects/p/topics/t", payload);
Memo1->Text = PubSub->Pull("projects/p/subscriptions/s", 10);

内部功能

封装了 Pub/Sub REST 接口,使用标准的 Google 服务账号认证流程。

主题管理

CreateTopic, DeleteTopic, GetTopic, ListTopics hit the /projects/<id>/topics endpoint family.

发布

Publish 发送一条或多条带可选属性和排序键的 PubsubMessage,返回分配的 messageIds

拉取 / 确认

Pull(subscription, maxMessages) 返回带有 ackId 的已接收消息;Acknowledge(subscription, ackIds) 完成确认,ModifyAckDeadline 延长处理时间。

服务账号 JWT

与 FCM 和 Calendar 兄弟组件相同的认证流程 — 加载 JSON 密钥,签署 RS256 JWT,换取 OAuth 令牌,按需刷新。

订阅管理

CreateSubscription, DeleteSubscription, UpdateSubscription, ListSubscriptions manage the subscription side of Pub/Sub.

推送或拉取

拉取订阅使用 Pull 读取;推送订阅配置为调用您的端点 — 通常是公网 URL 后面的 TsgcWebSocketHTTPServer 实例。

规范与参考

本组件所实现 API 的权威来源。

文档与演示

直达组件参考,获取可立即运行的演示项目,并下载试用版。

在线帮助 — Google Pub/Sub Client 本组件的完整属性、方法和事件参考。
演示项目 — Demos\20.HTTP_Protocol\03.Google 可立即运行的示例项目,随 sgcWebSockets 包一起提供 — 请从下方下载试用版。
技术文档 (PDF) 仅涵盖本组件的功能、快速入门、Delphi 和 C++ Builder 代码示例及主要参考来源。
用户手册 (PDF) 涵盖库中每个组件的综合手册。

准备好从 Delphi 使用 Cloud Pub/Sub 了吗?

下载免费试用版,将 Google Cloud Pub/Sub 集成到您的 Delphi 应用程序中。