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 和/或其關聯企業的註冊商標。
  上次更新時間:2025-07-26 (世界標準時間)。
  
  
    
    
    
      
  
    
  
  
    
      [[["容易理解","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"]],["上次更新時間:2025-07-26 (世界標準時間)。"],[],[]]