建立 Google 日曆介面

Google Workspace 外掛程式可以提供自訂 介面。 如此一來，您便能為使用者提供其他相關資訊， 工作，以及將第三方系統連結至 Google 日曆。

建立 Google 日曆外掛程式介面時，您可以提供 首頁。您也可以使用相同的 首頁提供多個主辦人的首頁，或是為 Google 日曆設計專屬網站。

您的外掛程式也可以定義 日曆活動。

存取外掛程式 UI

視開啟方式而定，Google Workspace 外掛程式可以定義首頁介面、Google 日曆活動介面、附件選取介面，或同時定義全部三種：

• 如果使用者在日曆檢視畫面中點選外掛程式圖示，外掛程式就會執行 相應的 calendar.homepageTrigger 函數 (如果有的話)。這個函式會建立並傳回首頁資訊卡 改為顯示在日曆上如果答案為「否」 calendar.homepageTrigger敬上 函式，將改為顯示一般首頁資訊卡。
• 如果使用者開啟日曆活動後按一下外掛程式圖示， 這個外掛程式會在使用者開啟事件時開啟 就會執行相應的 eventOpenTrigger敬上 函數 (如果有的話)。這個函式會建立外掛程式的日曆活動 介面並傳回「Google 日曆」以顯示內容。
• 如果外掛程式定義了 eventAttachmentTrigger 函式， 如果使用者在編輯日曆活動時點選「新增附件」，這個外掛程式就會顯示為附件提供者。選取外掛程式後 eventAttachmentTrigger 函式會建立外掛程式附件 選取介面並傳回「Google 日曆」即可顯示內容。

建構外掛程式的日曆介面

你可以透過 Google Workspace 外掛程式的步驟如下：

1. 決定您是否希望外掛程式具有 Google 日曆專用的功能 首頁。 另外再決定是否要提供自訂介面 編輯日曆活動。
2. 新增適當的 addOns.common敬上 和 addOns.calendar 新增至外掛程式指令碼專案資訊清單的欄位 包括任何所需的範圍。
3. 如果您要提供日曆專用的 homepage 實作 calendar.homepageTrigger敬上 函式來建構這個介面。您也可以選擇使用 common.homepageTrigger敬上 顯示多名 Google Workspace 主機的介面。
4. 如果要提供「日曆活動」介面，則必須實作 calendar.eventOpenTrigger敬上 函式來建構這個介面。詳情請見 擴充日曆活動介面 。
5. 實作回應使用者的回呼所需的關聯回呼函式 使用者介面互動，例如按鈕點擊。

日曆首頁

Google 日曆支援顯示 Google Workspace 外掛程式首頁。 如要在 Google 日曆中顯示外掛程式的通用首頁， 是addOns.calendar 欄位。

或者，新增 calendar.homepageTrigger敬上 加入外掛程式資訊清單，以提供 Google 日曆專用的首頁。

不論是哪一種情況，您都必須在 外掛程式的指令碼專案。系統會自動呼叫這個函式來建構 視需要使用 Google 日曆首頁。您必須實作這個函式以建構 然後傳回一個 Card 或 Card 構成首頁的 物件首頁觸發函式的 事件物件 做為參數，其中包含一些一般資訊，例如客戶的 平台。您可以使用事件物件資料，自訂 首頁。

擴充日曆活動介面

Google 日曆仰賴內容相關觸發條件來判斷哪個介面 (如有) 會在使用者編輯日曆活動時顯示。當觸發條件 就會執行 calendar.eventOpenTrigger敬上 ] 欄位。

您必須實作 calendar.eventOpenTrigger敬上 ] 欄位。這個函式接受事件物件做為 引數，而且必須傳回 Card 物件或 Card 物件 在使用者開啟活動時顯示。

事件物件

系統會建立事件物件， 會傳遞到 calendar.eventOpenTrigger敬上 使用者開啟時，內容相關觸發條件函式 日曆活動。觸發函式可以使用這個事件中的資訊 物件，決定如何建構外掛程式資訊卡或控制外掛程式 行為事件物件也會在建立後傳遞至 homepageTrigger敬上 函式，且只在使用者初次開啟外掛程式時，以及使用者點擊或選取廣告時選取 互動式小工具。

事件物件的完整結構說明 事件物件： 如果 Google 日曆是外掛程式的相關主機應用程式，內容相關觸發條件 小工具互動事件物件包括 日曆活動物件 ] 欄位傳送 Google 日曆專屬用戶端資訊。

更新日曆活動

除了內容比對 calendar.eventOpenTrigger敬上 會在使用者開啟 編輯日曆活動，您也可以定義 calendar.eventUpdateTrigger 在使用者更新並儲存「日曆活動」時觸發。僅限這個觸發條件 當使用者進行以下一項或多項編輯時，就會觸發：

• 新增一或多位參與者。
• 移除一或多位參與者。
• 新增或改用其他會議解決方案。

這個觸發條件啟動時，系統會執行 觸發函式的 calendar.eventUpdateTrigger敬上 資訊清單。這個函式會在日曆活動編輯開始前執行 已儲存。

calendar.eventUpdateTrigger 通常用於執行下列一或多項操作：

• 根據使用者變更，更新外掛程式的 Google 日曆活動介面 加入日曆活動。
• 透過第三方系統同步處理日曆活動資料，例如會議通訊 已連結至 Google 日曆

如要使用外掛程式調整 Google 日曆活動的資料 (例如 顯示為參與者清單)，您必須將外掛程式設定 calendar.currentEventAccess敬上 WRITE 或 READ_WRITE 資訊清單欄位。這也 外掛程式必須具有 https://www.googleapis.com/auth/calendar.addons.current.event.write scope。

新增會議解決方案

會議解決方案 代表第三方會議選項，可供使用者附加至 Google 日曆活動。 第三方會議總覽 說明文件，詳細說明如何建構外掛程式 會議解決方案。不必為這種類型的 UI 建構 UI 副檔名；新增的解決方案會顯示為選項 Google 日曆活動 UI。