Google Calendar API 资源（术语解释）

最新推荐文章于 2020-09-02 04:33:55 发布

赤石俊哉

最新推荐文章于 2020-09-02 04:33:55 发布

阅读量1.4k

点赞数

分类专栏： Google-API 文章标签：谷歌日历日历API

Google-API 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

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集合的区别，我们将会在日历和日历列表一节中给出解释。