進階日曆服務能讓您在 Apps Script 中使用公開的 Google Calendar API。這個 API 與 Apps Script 的內建日曆服務類似,可讓指令碼存取及修改使用者的 Google 日曆,包括使用者訂閱的其他日曆。在大多數情況下,內建服務較容易使用,但這項進階服務提供幾項額外功能,包括設定個別事件的背景顏色。
參考資料
如要進一步瞭解這項服務,請參閱公開 Google Calendar API 的參考說明文件。如同 Apps Script 的所有進階服務,進階日曆服務會使用與公用 API 相同的物件、方法和參數。詳情請參閱「如何判定方法簽章」一文。
如要回報問題及尋求其他支援,請參閱日曆支援指南。
HTTP 要求標頭
進階日曆服務可接受 HTTP 要求標頭 If-Match
和 If-None-Match
。詳情請參閱參考說明文件。
程式碼範例
下方程式碼範例使用第 3 版的 API。
建立事件
以下範例說明如何在使用者的預設日曆中建立事件。
列出日曆
以下範例說明如何擷取使用者日曆清單中顯示的日曆詳細資料。
列出事件
以下範例說明如何列出使用者預設日曆中的接下來 10 個近期活動。
有條件地修改事件
以下範例說明如何使用 If-Match
標頭,有條件地更新日曆活動。這個指令碼會建立新的事件,等待 30 秒,然後只在事件建立後沒有變更事件詳細資料時更新事件。
有條件擷取事件
以下範例說明如何使用 If-None-Match
標頭,有條件地擷取日曆活動。這個指令碼會建立新事件,然後輪詢事件 30 秒。只要事件變更,系統就會擷取新版本。
同步處理活動
以下範例說明如何使用同步權杖擷取事件。您在日曆進階服務要求中加入同步處理權杖後,產生的回應只會包含自該權杖產生後變更的項目,以便提升處理效率。如要進一步瞭解同步處理程序,請參閱「有效率地同步處理資源」。
以下範例使用上述範例定義的相同 getRelativeDate(daysOffset, hour)
方法。