進階日曆服務可讓您在 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 秒。只要事件變更,系統就會擷取新版本。
同步處理活動
以下範例說明如何使用同步權杖擷取事件。當您在 Google 日曆進階服務要求中加入同步處理憑證時,產生的回應只會包含自憑證產生後變更的項目,以更有效率地處理。如要進一步瞭解同步處理程序,請參閱有效率地同步處理資源。
以下範例使用上述範例中定義的相同 getRelativeDate(daysOffset, hour)
方法。