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 資源