Google Calendar API 資源(術語解釋)

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資源允許你從一個給定的日曆或者一些列日曆中查詢繁忙的時間。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章