Calendar API 背景
日曆概念
Google 日曆採用下列幾種基本概念:
- 活動
- 日曆中的單一活動,包含活動名稱、開始和結束時間以及參與者等資訊。
- 日曆
- 單一日曆項目,包含日曆的中繼資料,例如說明。
- 日曆清單
- Google 日曆 UI 中,列出使用者日曆清單的所有日曆。
- 設定
- Google 日曆 UI 中的使用者偏好,例如使用者的時區。
- ACL
- 包含規則類型和範圍等資訊的單一存取權控管規則。
Calendar API 資料模型
資源是具有專屬 ID 的個別資料實體。Calendar API 會對以下五種資源進行操作:
- 事件資源
- 代表日曆上的單一活動。
- 日曆資源
- 代表個別日曆的中繼資料。
- CalendarList 資源
- 代表使用者日曆清單中個別日曆的中繼資料。
- 設定資源
- 代表 Google 日曆 UI 中的單一使用者偏好設定。
- ACL 資源
- 代表 ACL。
Calendar API 資料模型是以資源群組為基礎,稱為集合:
- 事件集合
- 由特定日曆資源中的所有「活動資源」組成。
- 日曆清單集合
- 內含特定使用者的所有 calendarList 資源。
- 設定集合
- 由特定使用者擁有的所有設定資源。
- ACL 集合
- 包含所有套用至特定日曆的 ACL 資源。