提供意見
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"
),在日曆 UI 中稱為「Grape」。
PALE_RED
Enum
日曆 UI 中的淡紅色 ("4"
),稱為「Flamingo」。
YELLOW
Enum
黃色 ("5"
),在 Google 日曆 UI 中稱為「Banana」。
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 中稱為「番茄形」。
屬性
屬性 類型 說明
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-11-08 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","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"]],["上次更新時間:2024-11-08 (世界標準時間)。"],[[["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."]]],[]]