Google Calendar v3

从 Delphi 读写 Google Calendar v3。使用服务账号或 OAuth 2.0 用户身份验证管理事件、忙闲时段、日历和访问控制列表。

TsgcHTTPGoogleCloud_Calendar_Client

类型化的 Google Calendar v3 客户端 — events.list / insert / update / delete、日历 CRUD、freebusy.query,以及标准服务账号或 OAuth 用户认证流程。

组件类

TsgcHTTPGoogleCloud_Calendar_Client

平台

Windows, macOS, Linux, iOS, Android

版本

Standard / Professional / Enterprise

加载凭据,列出事件,插入事件

提供服务账号 JSON 或 OAuth 用户令牌,然后调用 ListEvents、InsertEvent、UpdateEvent 和 DeleteEvent。

uses
  sgcHTTP;

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

  // list upcoming events
  Memo1.Text := Calendar.ListEvents('primary');

  // insert event
  Calendar.InsertEvent('primary',
    '{"summary":"Quick sync","start":{"dateTime":"2026-05-15T10:00:00Z"},"end":{"dateTime":"2026-05-15T10:30:00Z"}}');
end;
// uses: sgcHTTP
TsgcHTTPGoogleCloud_Calendar_Client *Calendar = new TsgcHTTPGoogleCloud_Calendar_Client(this);
Calendar->GoogleCloudOptions->ServiceAccountJSON->LoadFromFile("service-account.json");

Memo1->Text = Calendar->ListEvents("primary");

内部功能

与其他 Google Cloud 组件使用相同认证流程的 Calendar v3 REST 类型化客户端。

事件 CRUD

ListEventsGetEventInsertEventUpdateEventPatchEventDeleteEventQuickAdd 对应 events v3 端点。

日历 / 访问控制列表

ListCalendarsGetCalendarInsertCalendarDeleteCalendarListACLInsertACL 管理日历列表和访问控制规则。

忙闲查询

FreeBusy 查询 freebusy.query 端点,检索日历列表和时间范围内的忙闲信息 — 适用于日程安排助手。

服务账号或 OAuth

域级服务账号委托适用于 Workspace 租户。对于个人账号,请搭配 TsgcHTTP_OAuth2_Client 并提供用户的访问令牌。

推送通知

使用 WatchEvents 注册 Calendar Webhook(推送通道)— 传入的通知可由 TsgcWebSocketHTTPServer 处理。

JSON 输入,JSON 输出

每个方法均返回原始 Calendar v3 JSON 响应——无需影子类型系统——您可以直接使用 Google 的数据模式。

规范与参考

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

文档与演示

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

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

准备好从 Delphi 使用 Google Calendar 了吗?

下载免费试用版,将 Google Calendar v3 集成到您的 Delphi 应用程序中。