Calendar Service
日曆
這項服務可讓指令碼存取及修改使用者的 Google 日曆,包括使用者訂閱的其他日曆。
類別
方法
方法 | 傳回類型 | 簡短說明 |
createAllDayEvent(title, date) | CalendarEvent | 建立新的全天活動。 |
createAllDayEvent(title, startDate, endDate) | CalendarEvent | 建立可跨越多天的全天活動。 |
createAllDayEvent(title, startDate, endDate, options) | CalendarEvent | 建立可跨越多天的全天活動。 |
createAllDayEvent(title, date, options) | CalendarEvent | 建立新的全天活動。 |
createAllDayEventSeries(title, startDate, recurrence) | CalendarEventSeries | 建立新的全天活動系列。 |
createAllDayEventSeries(title, startDate, recurrence, options) | CalendarEventSeries | 建立新的全天活動系列。 |
createEvent(title, startTime, endTime) | CalendarEvent | 建立新事件。 |
createEvent(title, startTime, endTime, options) | CalendarEvent | 建立新事件。 |
createEventFromDescription(description) | CalendarEvent | 根據任意形式說明建立事件。 |
createEventSeries(title, startTime, endTime, recurrence) | CalendarEventSeries | 建立新的事件系列。 |
createEventSeries(title, startTime, endTime, recurrence, options) | CalendarEventSeries | 建立新的事件系列。 |
deleteCalendar() | void | 永久刪除日曆。 |
getColor() | String | 取得日曆的顏色。 |
getDescription() | String | 取得日曆的說明。 |
getEventById(iCalId) | CalendarEvent | 取得具有指定 ID 的事件。 |
getEventSeriesById(iCalId) | CalendarEventSeries | 取得具有指定 ID 的系列活動。 |
getEvents(startTime, endTime) | CalendarEvent[] | 取得在指定時間範圍內發生的所有事件。 |
getEvents(startTime, endTime, options) | CalendarEvent[] | 取得在指定時間範圍內發生且符合指定條件的所有事件。 |
getEventsForDay(date) | CalendarEvent[] | 取得特定日期發生的所有事件。 |
getEventsForDay(date, options) | CalendarEvent[] | 取得在特定日期發生且符合指定條件的所有事件。 |
getId() | String | 取得日曆的 ID。 |
getName() | String | 取得日曆名稱。 |
getTimeZone() | String | 取得日曆的時區。 |
isHidden() | Boolean | 決定日曆是否會在使用者介面中隱藏。 |
isMyPrimaryCalendar() | Boolean | 判斷日曆是否為有效使用者的主要日曆。 |
isOwnedByMe() | Boolean | 判斷日曆是否由您擁有。 |
isSelected() | Boolean | 決定是否在使用者介面中顯示日曆活動。 |
setColor(color) | Calendar | 設定日曆的顏色。 |
setDescription(description) | Calendar | 設定日曆的說明。 |
setHidden(hidden) | Calendar | 設定日曆是否會顯示在使用者介面中。 |
setName(name) | Calendar | 設定日曆的名稱。 |
setSelected(selected) | Calendar | 設定是否要在使用者介面中顯示日曆活動。 |
setTimeZone(timeZone) | Calendar | 設定日曆的時區。 |
unsubscribeFromCalendar() | void | 取消使用者訂閱日曆。 |
方法
方法 | 傳回類型 | 簡短說明 |
createAllDayEvent(title, date) | CalendarEvent | 建立新的全天活動。 |
createAllDayEvent(title, startDate, endDate) | CalendarEvent | 建立可跨越多天的全天活動。 |
createAllDayEvent(title, startDate, endDate, options) | CalendarEvent | 建立可跨越多天的全天活動。 |
createAllDayEvent(title, date, options) | CalendarEvent | 建立新的全天活動。 |
createAllDayEventSeries(title, startDate, recurrence) | CalendarEventSeries | 建立新的全天活動系列。 |
createAllDayEventSeries(title, startDate, recurrence, options) | CalendarEventSeries | 建立新的全天活動系列。 |
createCalendar(name) | Calendar | 建立使用者擁有的新日曆。 |
createCalendar(name, options) | Calendar | 建立使用者擁有的新日曆。 |
createEvent(title, startTime, endTime) | CalendarEvent | 建立新事件。 |
createEvent(title, startTime, endTime, options) | CalendarEvent | 建立新事件。 |
createEventFromDescription(description) | CalendarEvent | 根據任意形式說明建立事件。 |
createEventSeries(title, startTime, endTime, recurrence) | CalendarEventSeries | 建立新的事件系列。 |
createEventSeries(title, startTime, endTime, recurrence, options) | CalendarEventSeries | 建立新的事件系列。 |
getAllCalendars() | Calendar[] | 取得使用者擁有或訂閱的所有日曆。 |
getAllOwnedCalendars() | Calendar[] | 取得使用者擁有的所有日曆。 |
getCalendarById(id) | Calendar | 取得具有指定 ID 的日曆。 |
getCalendarsByName(name) | Calendar[] | 取得使用者擁有或訂閱的所有指定名稱日曆。 |
getColor() | String | 取得日曆的顏色。 |
getDefaultCalendar() | Calendar | 取得使用者的預設日曆。 |
getDescription() | String | 取得日曆的說明。 |
getEventById(iCalId) | CalendarEvent | 取得具有指定 ID 的事件。 |
getEventSeriesById(iCalId) | CalendarEventSeries | 取得具有指定 ID 的系列活動。 |
getEvents(startTime, endTime) | CalendarEvent[] | 取得在指定時間範圍內發生的所有事件。 |
getEvents(startTime, endTime, options) | CalendarEvent[] | 取得在指定時間範圍內發生且符合指定條件的所有事件。 |
getEventsForDay(date) | CalendarEvent[] | 取得特定日期發生的所有事件。 |
getEventsForDay(date, options) | CalendarEvent[] | 取得在特定日期發生且符合指定條件的所有事件。 |
getId() | String | 取得日曆的 ID。 |
getName() | String | 取得日曆的名稱。 |
getOwnedCalendarById(id) | Calendar | 取得使用者擁有的指定 ID 日曆。 |
getOwnedCalendarsByName(name) | Calendar[] | 取得使用者擁有的所有指定名稱日曆。 |
getTimeZone() | String | 取得日曆的時區。 |
isHidden() | Boolean | 決定日曆是否會在使用者介面中隱藏。 |
isMyPrimaryCalendar() | Boolean | 判斷日曆是否為有效使用者的主要日曆。 |
isOwnedByMe() | Boolean | 判斷日曆是否由您擁有。 |
isSelected() | Boolean | 決定是否在使用者介面中顯示日曆活動。 |
newRecurrence() | EventRecurrence | 建立新的週期物件,可用於建立事件週期規則。 |
setColor(color) | Calendar | 設定日曆的顏色。 |
setDescription(description) | Calendar | 設定日曆的說明。 |
setHidden(hidden) | Calendar | 設定日曆是否會顯示在使用者介面中。 |
setName(name) | Calendar | 設定日曆的名稱。 |
setSelected(selected) | Calendar | 設定是否要在使用者介面中顯示日曆活動。 |
setTimeZone(timeZone) | Calendar | 設定日曆的時區。 |
subscribeToCalendar(id) | Calendar | 如果使用者獲准訂閱,系統會使用指定 ID 訂閱日曆。 |
subscribeToCalendar(id, options) | Calendar | 如果使用者獲准訂閱,系統會使用指定 ID 訂閱日曆。 |
屬性
屬性 | 類型 | 說明 |
BLUE | Enum |
藍色 (#2952A3 )。 |
BROWN | Enum |
棕色 (#8D6F47 )。 |
CHARCOAL | Enum |
石墨黑 (#4E5D6C )。 |
CHESTNUT | Enum |
栗棕 (#865A5A )。 |
GRAY | Enum |
灰色 (#5A6986 )。 |
GREEN | Enum |
綠色 (#0D7813 )。 |
INDIGO | Enum |
Indigo (#5229A3 )。 |
LIME | Enum |
Lime (#528800 )。 |
MUSTARD | Enum |
芥末 (#88880E )。 |
OLIVE | Enum |
Olive (#6E6E41 )。 |
ORANGE | Enum |
橘色 (#BE6D00 )。 |
PINK | Enum |
粉紅色 (#B1365F )。 |
PLUM | Enum |
紫紅色 (#705770 )。 |
PURPLE | Enum |
紫色 (#7A367A )。 |
RED | Enum |
紅色 (#A32929 )。 |
RED_ORANGE | Enum |
紅橘色 (#B1440E )。 |
SEA_BLUE | Enum |
海水藍 (#29527A )。 |
SLATE | Enum |
插入畫面 (#4A716C )。 |
TEAL | Enum |
藍綠色 (#28754E )。 |
TURQOISE | Enum |
藍綠色 (#1B887A )。 |
YELLOW | Enum |
黃色 (#AB8B00 )。 |
屬性
屬性 | 類型 | 說明 |
PALE_BLUE | Enum |
淡藍色 ("1" ),在日曆 UI 中稱為「孔雀」。 |
PALE_GREEN | Enum |
灰綠色 ("2" ),在日曆 UI 中稱為「Sage」。 |
MAUVE | Enum |
Mauve ("3" ),在 Google 日曆 UI 中稱為「葡萄色」。 |
PALE_RED | Enum |
淡紅色 ("4" ),在日曆 UI 中稱為「火鶴」。 |
YELLOW | Enum |
黃色 ("5" ),在 Google 日曆 UI 中稱為「香蕉」。 |
ORANGE | Enum |
橘色 ("6" ),在 Google 日曆 UI 中稱為「橘色」。 |
CYAN | Enum |
青色 ("7" ),在日曆 UI 中稱為「薰衣草色」。 |
GRAY | Enum |
灰色 ("8" ),在日曆 UI 中稱為「Graphite」。 |
BLUE | Enum |
藍色 ("9" ),在日曆 UI 中稱為「藍莓」。 |
GREEN | Enum |
綠色 ("10" ),在日曆 UI 中稱為「Basil」。 |
RED | Enum |
紅色 ("11" ),在日曆 UI 中稱為「番茄形」。 |
屬性
屬性 | 類型 | 說明 |
OPAQUE | Enum | 活動會在日曆上顯示為已預約的時間。 |
TRANSPARENT | Enum | 活動不會在日曆上阻擋時間。 |
屬性
屬性 | 類型 | 說明 |
DEFAULT | Enum | 活動為一般活動。 |
BIRTHDAY | Enum | 這項活動是每年週期性重複發生的全天活動。 |
FOCUS_TIME | Enum | 該事件是專注時間活動。 |
FROM_GMAIL | Enum | 活動是 Gmail 中的活動。 |
OUT_OF_OFFICE | Enum | 活動是不在辦公室的活動。 |
WORKING_LOCATION | Enum | 活動是工作地點活動。 |
屬性
屬性 | 類型 | 說明 |
INVITED | Enum | 受邀者已收到邀請,但尚未表示是否會出席。 |
MAYBE | Enum | 邀請對象表示可能會出席。 |
NO | Enum | 邀請對象已表示不會出席。 |
OWNER | Enum | 邀請對象是活動擁有者。 |
YES | Enum | 邀請對象已表示會出席。 |
屬性
屬性 | 類型 | 說明 |
CONFIDENTIAL | Enum | 這是私人活動。 |
DEFAULT | Enum | 使用日曆中活動的預設瀏覽權限。 |
PRIVATE | Enum | 這是私人活動,只有活動參與者才能查看活動詳細資料。 |
PUBLIC | Enum | 活動為公開,所有日曆讀者都能查看活動詳細資料。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-22 (世界標準時間)。
[null,null,["上次更新時間:2024-12-22 (世界標準時間)。"],[[["The Google Apps Script Calendar Service enables interaction with Google Calendars, allowing scripts to create, modify, and delete events and calendars."],["It offers classes like `Calendar`, `CalendarApp`, and `CalendarEvent` with specific methods for managing various calendar aspects."],["Recurring events are handled through `CalendarEventSeries` and `RecurrenceRule`, which provide extensive options for recurrence patterns and exclusions."],["The service utilizes enums like `Color`, `EventColor`, and `Visibility` to define event properties."],["`CalendarEvent` methods allow detailed control over event details, such as reminders, guests, and visibility settings."]]],[]]