日历 API 背景
日历概念
Google 日历基于以下几个基本概念:
- 事件
- 日历上的单个活动,其中包含活动标题、开始时间和结束时间以及参加者等信息。
- 日历
- 包含日历元数据(例如说明)的单个日历条目。
- 日历列表
- 日历界面中用户日历列表中所有日历的列表。
- 设置
- 日历界面的用户偏好设置,例如用户的时区。
- ACL
- 一条访问权限控制规则,其中包含规则的类型和范围等信息。
日历 API 数据模型
资源是具有唯一标识符的单个数据实体。Calendar API 基于五种类型的资源运行:
- 事件资源
- 表示日历上的单个活动。
- 日历资源
- 表示单个日历的元数据。
- 日历列表资源
- 表示界面中用户日历列表中显示的单个日历的元数据。
- 设置资源
- 表示日历界面中的单个用户偏好设置。
- ACL 资源
- 表示 ACL。
Google 日历 API 数据模型基于资源组(称为集合):
- 活动收集
- 包含特定日历资源中的所有活动资源。
- CalendarList 集合
- 包含特定用户的所有 CalendarList 资源。
- 设置集合
- 包含特定用户的所有设置资源。
- ACL 集合
- 包含应用于特定日历的所有 ACL 资源。