Calendar API のリソースタイプ

Calendar API の背景

カレンダーのコンセプト

Google カレンダーは、次のような基本概念に基づいて構築されています。

イベント

カレンダー上の 1 つの予定で、予定のタイトル、開始時間、終了時間、参加者などの情報が含まれます。

カレンダー

カレンダーのメタデータ（説明など）を含む 1 つのカレンダー エントリ。

カレンダー リスト

カレンダー UI でユーザーのカレンダー リストに表示されるすべてのカレンダーのリスト。

設定

ユーザーのタイムゾーンなど、カレンダー UI のユーザー設定。

ACL

ルールのタイプや範囲などの情報を含む単一のアクセス制御ルール。

Calendar API データモデル

リソースとは、一意の識別子を持つ個別のデータ エンティティです。Calendar API は、次の 5 種類のリソースで動作します。

イベント リソース

カレンダー上の 1 つの予定を表します。

カレンダーのリソース

個々のカレンダーのメタデータを表します。

CalendarList リソース

UI のユーザーのカレンダー リストに表示される個々のカレンダーのメタデータを表します。

設定リソース

カレンダー UI の 1 つのユーザー設定を表します。

ACL リソース

ACL を表します。

Calendar API のデータモデルは、コレクションと呼ばれるリソースのグループに基づいています。

イベント コレクション

特定のカレンダー リソース内のすべての予定リソースで構成されています。

CalendarList コレクション

特定のユーザーのすべての CalendarList リソースで構成されています。

設定コレクション

特定のユーザーのすべての設定リソースで構成されます。

ACL コレクション

特定のカレンダーに適用されるすべての ACL リソースで構成されています。