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|null | 取得具有指定 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|null | 如果使用者擁有指定 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 |
橄欖色 (#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 中稱為「鼠尾草」。 |
MAUVE | Enum |
紫紅色 ("3"),在日曆 UI 中稱為「葡萄」。 |
PALE_RED | Enum |
淺紅色 ("4"),在日曆 UI 中稱為「火鶴」。 |
YELLOW | Enum |
黃色 ("5"),在 Google 日曆使用者介面中稱為「香蕉」。 |
ORANGE | Enum |
橘色 ("6"),在日曆 UI 中稱為「橙橘色」。 |
CYAN | Enum |
青色 ("7"),在 Google 日曆使用者介面中稱為「孔雀藍」。 |
GRAY | Enum |
灰色 ("8"),在日曆使用者介面中稱為「石墨色」。 |
BLUE | Enum |
藍色 ("9"),在日曆 UI 中稱為「藍莓」。 |
GREEN | Enum |
綠色 ("10"),在日曆 UI 中稱為「羅勒」。 |
RED | Enum |
紅色 ("11"):在日曆使用者介面中稱為「番茄」。 |
屬性
| 屬性 | 類型 | 說明 |
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 和/或其關聯企業的註冊商標。
上次更新時間:2026-03-06 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2026-03-06 (世界標準時間)。"],[],[]]