Google Calendar v3 クライアント (TsgcHTTPGoogleCloud_Calendar_Client) — sgcWebSockets

概要

TsgcHTTPGoogleCloud_Calendar_Client

型付き Google Calendar v3 クライアントです。events.list / insert / update / delete、カレンダーの CRUD、freebusy.query に対応し、標準のサービスアカウントまたは OAuth ユーザー認証フローをサポートしています。

コンポーネントクラス

TsgcHTTPGoogleCloud_Calendar_Client

プロトコル

Google Calendar API v3

対応プラットフォーム

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

ListEvents、GetEvent、InsertEvent、UpdateEvent、PatchEvent、DeleteEvent、QuickAdd が events v3 エンドポイントにマッピングされています。

カレンダー / ACL

ListCalendars、GetCalendar、InsertCalendar、DeleteCalendar、ListACL、InsertACL がカレンダーリストとアクセス制御ルールを管理します。

空き時間の照会

FreeBusy は、カレンダーのリストと時間範囲を指定して freebusy.query エンドポイントを照会します。スケジュール管理アシスタントに役立ちます。

サービスアカウントまたは OAuth

ドメイン全体のサービスアカウント委任は Workspace テナントで機能します。コンシューマーアカウントの場合は TsgcHTTP_OAuth2_Client と組み合わせ、ユーザーのアクセストークンを指定してください。

プッシュ通知

WatchEvents を使用して Calendar Webhook（プッシュチャネル）を登録します。受信した通知は TsgcWebSocketHTTPServer で処理できます。

JSON 入出力

すべてのメソッドは Calendar v3 の生の JSON レスポンスを返します。独自の型システムはないため、Google のスキーマを直接操作できます。

標準規格

仕様・参考資料

このコンポーネントが実装する API の公式ソースです。

リソース

ドキュメント・デモ

コンポーネントリファレンスへの直接リンク、すぐに実行できるデモプロジェクトの入手、体験版のダウンロードができます。

	オンラインヘルプ — Google Calendar クライアントこのコンポーネントのプロパティ、メソッド、イベントの完全なリファレンスです。	開く
	デモプロジェクト — Demos\20.HTTP_Protocol\03.Google すぐに実行できるサンプルプロジェクトです。sgcWebSockets パッケージに同梱されています。以下から体験版をダウンロードできます。	開く
	技術ドキュメント (PDF) このコンポーネントの機能、クイックスタート、Delphi および C++ Builder 向けのコードサンプル、一次資料のリファレンスを掲載しています。	開く
	ユーザーマニュアル (PDF) ライブラリのすべてのコンポーネントを網羅した総合マニュアルです。	開く

Google Calendar v3