Calendar API 資源類型

Calendar API 背景

日曆概念

Google 日曆採用下列幾種基本概念：

活動

日曆中的單一活動，包含活動名稱、開始和結束時間以及參與者等資訊。

日曆

單一日曆項目，包含日曆的中繼資料，例如說明。

日曆清單

Google 日曆 UI 中，列出使用者日曆清單的所有日曆。

設定

Google 日曆 UI 中的使用者偏好，例如使用者的時區。

ACL

包含規則類型和範圍等資訊的單一存取權控管規則。

Calendar API 資料模型

資源是具有專屬 ID 的個別資料實體。Calendar API 會對以下五種資源進行操作：

事件資源

代表日曆上的單一活動。

日曆資源

代表個別日曆的中繼資料。

CalendarList 資源

代表使用者日曆清單中個別日曆的中繼資料。

設定資源

代表 Google 日曆 UI 中的單一使用者偏好設定。

ACL 資源

代表 ACL。

Calendar API 資料模型是以資源群組為基礎，稱為集合：

事件集合

由特定日曆資源中的所有「活動資源」組成。

日曆清單集合

內含特定使用者的所有 calendarList 資源。

設定集合

由特定使用者擁有的所有設定資源。

ACL 集合

包含所有套用至特定日曆的 ACL 資源。