Google Calendar
隨附於 Macro Deck在面板上顯示 Google Calendar 事件，倒數下一場會議，一鍵加入會議。
行事曆小工具，顯示未來幾天的行程、附倒數計時的下一個活動和精簡行程
- 在行事曆小工具上顯示議程和下一個事件
- 在事件開始前、開始時和結束後觸發
- 一鍵加入目前的會議
- 連線多個 Google 帳戶
- 以唯讀方式存取行事曆
Google Calendar 整合會讀取 Google 帳戶的行事曆，並將其中的事件提供給 Macro Deck 的行事曆功能使用：行事曆 小工具、行事曆觸發器和 加入會議 動作。Macro Deck 只會讀取，絕不會建立、變更或刪除事件。
Macro Deck 會透過在 Google Cloud 中自行建立的 OAuth 用戶端進行連線。建立用戶端免費，而且只需要做一次；Macro Deck 中的設定會逐步引導，並提供 Google Cloud Console 中相應頁面的連結。之後在瀏覽器中使用 Google 帳戶登入，並允許 Macro Deck 查看行事曆即可。
可以做什麼
- 行事曆小工具： 議程 版面配置會列出即將到來的事件，下一個事件 版面配置則會倒數下一個事件。按下小工具即可查看事件的詳細資訊，包括地點、說明、受邀者，以及 加入會議 按鈕。
- 觸發器： 事件即將開始、事件已開始 和 事件已結束 可在自動化或小工具中，於會議前後執行動作。可限定於單一帳戶或單一行事曆。
- 加入會議： 在執行 Macro Deck 的電腦上，開啟正在進行或即將開始的事件的會議連結。
設定範例：
- 在面板上放一個使用 加入會議 的按鍵，不必尋找連結就能加入目前的通話。
- 在 事件即將開始 上建立自動化，在工作行事曆中每個事件開始前 5 分鐘將音樂靜音。
- 在 事件已結束 上建立自動化，將面板切換回日常使用的設定檔。
運作方式
Macro Deck 每五分鐘讀取一次行事曆，範圍從昨天到大約一週後。重新整理行事曆 動作會立即讀取。週期性事件會顯示每一次的事件。在 Google Calendar 本身清單中隱藏的行事曆，Macro Deck 也會略過。
可以連線任意數量的 Google 帳戶，每個帳戶各為一個設定，而同一個 OAuth 用戶端可用於所有帳戶。無法讀取某個帳戶時，小工具會保留它最後已知的事件，並說明部分行事曆無法更新，整合 也會顯示該帳戶的通知。
行事曆小工具顯示的所有內容（包括說明和參與者），在連線到 Macro Deck 的每台裝置上都看得到。
需要準備
- 在 Windows、macOS 或 Linux 上執行的 Macro Deck 3
- 使用 Google Calendar 的 Google 帳戶
- 已啟用 Google Calendar API 的 Google Cloud 專案
- 類型為 Desktop app 的 OAuth 用戶端 ID，以及其用戶端 ID 和用戶端密鑰
- 執行 Macro Deck 的電腦上需有瀏覽器，用於 Google 登入
開始設定
步驟 1: 開啟 Google Calendar 設定
在側邊欄中按一下 整合，然後按一下 Google Calendar。在 概覽 分頁的 設定 下按一下 新增設定。開啟右上角的開關也會開啟相同的對話方塊，設定完成後此整合就會啟用。連線 Google 行事曆 對話方塊會列出下列步驟，並提供 Google Cloud Console 的連結，以及可複製的 重新導向 URI。
步驟 2: 啟用 Google Calendar API
在 Google Cloud Console（
https://console.cloud.google.com）中建立或選擇一個專案，並為它啟用 Google Calendar API。設定中以 啟用 Google Calendar API 連結到該頁面。步驟 3: 設定 OAuth 同意畫面
設定專案的 OAuth 同意畫面，並將發布狀態設為 In production。如果維持在 Testing，Google 會在 7 天後結束每次登入，就必須每週重新連線帳戶。
步驟 4: 建立 Desktop app 用戶端
在 APIs & Services > Credentials 下，建立應用程式類型為 Desktop app 的 OAuth 用戶端 ID。Desktop app 用戶端會接受設定中顯示的 重新導向 URI，例如
http://127.0.0.1:8193/api/integrations/oauth/callback，不需要在任何地方加入。步驟 5: 輸入用戶端 ID 和密鑰
將新用戶端的用戶端 ID 和用戶端密鑰複製到對話方塊的 用戶端 ID 和 用戶端密鑰 欄位中，然後按一下 繼續。瀏覽器會開啟 Google 登入頁面。Google 會警告尚未驗證此應用程式；對於自行建立的用戶端，這是正常的。選擇 Advanced，繼續前往應用程式，並允許存取行事曆。
步驟 6: 新增行事曆小工具
在 面板 頁面上新增 行事曆 小工具。在其設定中選擇 版面配置（議程 或 下一個事件）以及要顯示的 行事曆。將 行事曆 留空即可顯示所有已連線的行事曆。
步驟 7: 在按鈕上加入「加入會議」
在 面板 頁面上，確認面板已解鎖（右上角的按鈕顯示 鎖定），然後按一下一個按鈕。編輯器開啟時會選取 短按。按一下 + 新增動作，在 新增動作 對話方塊左側選擇 行事曆，然後選擇 加入會議。開始時間範圍 設定要提前多久加入即將開始的事件，預設為 15 分鐘，而 行事曆 可限定於單一行事曆。
動作3
可放在按鈕上，或從流程中執行。
- 加入會議
- 在執行 Macro Deck 的電腦上，開啟正在進行或即將開始的事件的會議連結。
- 重新整理行事曆
- 立即讀取所有已連線行事曆的事件，不必等待下一次更新。
- 顯示行事曆詳細資訊
- 開啟行事曆小工具的詳細資訊：下一個事件版面配置所顯示的事件，或議程的清單。
觸發器3
按鈕或流程可以對這些事件做出反應。
- 事件即將開始
- 在行事曆事件開始前的指定時間執行，預設為 15 分鐘。
- 事件已開始
- 在行事曆事件開始時執行。
- 事件已結束
- 在行事曆事件結束時執行。
變數1
在按鈕和小工具上顯示這些值，或在條件中使用。
calendar_next_title,calendar_next_countdown,calendar_next_minutes,calendar_next_meeting_url- 每個行事曆小工具為其顯示的事件保留的小工具變數：事件標題、距離事件的倒數、距離開始的分鐘數，以及會議連結。小工具也會保留事件的開始時間、結束時間、地點、所屬行事曆，以及事件是否正在進行。
小工具1
從小工具選擇器將這些小工具加入面板。
- 行事曆
- 以議程顯示即將到來的事件，或以倒數計時顯示下一個事件。
常見問題
為什麼需要自己的 Google Cloud 用戶端？
Macro Deck 會透過自行建立的 OAuth 用戶端讀取 Google Calendar。建立用戶端免費，而且設定中提供所有需要的頁面連結。同一個用戶端可用於所有連線的 Google 帳戶。
為什麼 Google 每週都要求重新登入？
Google Cloud 用戶端的 OAuth 同意畫面仍處於 Testing，而 Google 會在 7 天後結束每次登入。請將發布狀態設為 In production，然後在 Google Calendar 頁面上使用帳戶旁的 編輯連線 重新登入。
可以連線多個 Google 帳戶嗎？
可以。在 Google Calendar 頁面上按一下 新增設定，然後使用另一個帳戶登入。如果連線的帳戶已經連線過，整合 會顯示 Google 帳戶已連線兩次：請移除較舊的設定。
Macro Deck 會取得哪些存取權？
Macro Deck 只會向 Google 要求行事曆的讀取權限，以及用來命名帳戶的電子郵件地址。用戶端密鑰和登入資訊會加密儲存在執行 Macro Deck 的電腦上，而用戶端密鑰只會傳送給 Google。
為什麼新事件沒有立即顯示？
Macro Deck 每五分鐘讀取一次行事曆。使用 重新整理行事曆 動作即可立即讀取。大約一週以後的事件不會被讀取。
為什麼登入後沒有回到 Macro Deck？
請確認 OAuth 用戶端的應用程式類型為 Desktop app；其他類型只接受自行註冊的重新導向位址。如果 Macro Deck 只接受 HTTPS，請在 設定 > 網路 中將 監聽器模式 設為 使用額外的 HTTPS 連接埠，或在連線帳戶期間關閉 HTTPS。
更多「行事曆與電子郵件」整合
Outlook Calendar
隨附於 Macro Deck在面板上顯示 Outlook 和 Microsoft 365 行事曆，一鍵加入 Teams 會議。
電子郵件 (IMAP)
隨附於 Macro Deck在面板上查看任何 IMAP 收件匣的未讀郵件和最新郵件，並在收到郵件時做出反應。