Google Calendar API 资源(术语解释)
TODO: 本文由 赤石俊哉 翻译整理,如果需要转载,请征得原作者同意,并且转载后注明来源,谢谢您的理解与配合。
原文
API resources
Google Calendar uses the following resources, each detailed in the Reference section of this documentation.
Event — An event on a calendar containing information such as the title, start and end times, and attendees. Events can be either single events or recurring events. An event is represented by an Event resource. The Events collection for a given calendar contains all event resources for that calendar.
Calendar — A calendar is a collection of events. Each calendar has associated metadata, such as calendar description or default calendar time zone. The metadata for a single calendar is represented by a Calendar resource. The Calendars collection contains Calendar resources for all existing calendars.
Calendar List — A list of all calendars on a user’s calendar list in the Calendar UI. The metadata for a single calendar that appears on the calendar list is represented by a CalendarListEntry resource. This metadata includes user-specific properties of the calendar, such as its color or notifications for new events. The CalendarList collection contains all CalendarListEntry resources for a given user. For a further explanation of the difference betweeen the Calendars and CalendarList collections, see Calendar and Calendar List
Setting — A user preference from the Calendar UI, such as the user’s time zone. A single user preference is represented by a Setting Resource. The Settings collection contains all Setting resources for a given user.
ACL — An access control rule granting a user (or a group of users) a specified level of access to a calendar. A single access control rule is represented by an ACL resource. The ACL collection for a given calendar contains all ACL resources that grant access to that calendar.
Color — A color presented in the Calendar UI. The Colors resource represents the set of all colors available in the Calendar UI, in two groups: colors available for events and colors available for calendars.
Free/busy — A time when a calendar has events scheduled is considered “busy”, a time when a calendar has no events is considered “free”. The Freebusy resource allows querying for the set of busy times for a given calendar or set of calendars.
Google日历使用以下资源,在这个文档(Google Calendar API(英文))参考资料的每个小节中都有详细的说明。
事件 Event
日历上的事件包含了一些诸如标题、开始结束时间、参与者等信息。事件可以是一次性事件,也可以是可重复的事件。像这样的事件,使用一个Event
资源来表示,一个给定的日历的Events集合
包含这个日历的所有事件资源。
日历 Calendar
日历是事件的一个集合,每一个日历都有一个元信息来描述,比如日历的描述文字以及默认时区等。Calendar
资源就用来表示这些元信息。Calendars集合
包含了所有存在的日历的Calendar
资源。
日历列表 Calendar List
日历列表是在日历界面上列出的用户的所有日历。每一个显示在日历列表上的日历都有一个以CalendarListEntry
资源来表示的元信息。着个元信息包含了一些用户定义的属性,比如它的颜色,以及对于新事件的提醒。CalendarList集合
包含了给定用户的所有CalendarListEntry
资源。至于Calendar
资源和CalendarList
集合的区别,我们将会在日历和日历列表一节中给出解释。
设置 Setting
从日历界面上进行配置的用户偏好设置,比如用户的时区信息。Setting
资源用来表示一个用户的偏好设置。Settings集合
包含了给定用户的所有Setting
资源。
访问控制规则 ACL
一个访问控制规则用来指定一个用户(或者一组用户)一定的日历访问级别。ACL
资源用于表示一个访问控制规则,给定的日历的ACL集合
包含了日历定义的访问许可的所有ACL
资源。
颜色 Color
在日历界面中显示的颜色。Colors
资源表示日历界面可以使用的所有颜色,这些颜色分为两组:事件可以使用的颜色以及日历可以使用的颜色。
闲忙状态 Free/busy
如果日历上在某一时间有日程的话,将会被认为是繁忙
的,反之,没有日程安排的时候就是清闲
的,Freebusy
资源允许你从一个给定的日历或者一些列日历中查询繁忙的时间。