Calendar API 资源类型

日历 API 背景

日历概念

Google 日历基于以下几个基本概念:

事件
日历上的单个活动,其中包含活动标题、开始时间和结束时间以及参加者等信息。
日历
包含日历元数据(例如说明)的单个日历条目。
日历列表
日历界面中用户日历列表中所有日历的列表。
设置
日历界面的用户偏好设置,例如用户的时区。
ACL
一条访问权限控制规则,其中包含规则的类型和范围等信息。

日历 API 数据模型

资源是具有唯一标识符的单个数据实体。Calendar API 基于五种类型的资源运行:

事件资源
表示日历上的单个活动。
日历资源
表示单个日历的元数据。
日历列表资源
表示界面中用户日历列表中显示的单个日历的元数据。
设置资源
表示日历界面中的单个用户偏好设置。
ACL 资源
表示 ACL。

Google 日历 API 数据模型基于资源组(称为集合):

活动收集
包含特定日历资源中的所有活动资源
CalendarList 集合
包含特定用户的所有 CalendarList 资源
设置集合
包含特定用户的所有设置资源
ACL 集合
包含应用于特定日历的所有 ACL 资源