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