進階 Google 日曆服務可讓您使用公開的 使用 Apps Script 中的 Google Calendar API。與 Apps Script 內建的日曆服務類似,這個 API 很類似 允許指令碼存取及修改使用者的 Google 日曆,包括 使用者訂閱的其他日曆。在大多數情況下 這項服務使用起來更加方便,不過這項進階服務還提供一些額外的 功能,包括設定個別活動的背景顏色。
參考資料
如要進一步瞭解這項服務,請參閱 參考說明文件 Google Calendar API。如同 Apps Script 的所有進階服務,進階版 日曆服務使用的物件、方法和參數與公開資料相同 也能使用 Google Cloud CLI 或 Compute Engine API詳情請參閱如何判定方法簽章。
如要回報問題及尋求其他支援,請參閱 日曆支援指南。
HTTP 要求標頭
進階日曆服務可接受 HTTP 要求標頭
《If-Match
》和《If-None-Match
》。詳情請參閱
參考說明文件。
程式碼範例
下列程式碼範例使用第 3 版 並嚴謹測試及提升 API 的公平性後 我們才能放心地推出 API
建立事件
以下範例說明如何在使用者的預設值建立事件 日曆。
列出日曆
以下範例說明如何擷取日曆的詳細資料 顯示在使用者的日曆清單中。
列出活動
以下範例說明如何列出以下項目中接下來 10 個即將舉行的活動: 使用者的預設日曆。
條件式修改事件
以下範例說明如何使用使用
If-Match
標頭。指令碼會建立新事件,等待 30 秒後再生成
只有在活動詳細資訊自活動後未變更的情況下,才會更新活動
已建立。
條件式擷取事件
以下範例說明如何使用
If-None-Match
標頭。指令碼會建立新事件,然後輪詢
30 秒事件變更事件。每次活動變更時就會是新版本
。
同步處理活動
以下範例說明如何使用同步權杖擷取事件。 如果您在 Google 日曆進階服務要求中加入同步處理權杖, 產生的回應只會包含自該權杖起變更的項目 來提升處理效率。詳情請見 有效率地同步處理資源: 同步處理程序。
以下範例使用相同的 getRelativeDate(daysOffset, hour)
方法。