建立 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 日曆首頁。您必須實作這個函式以建構 然後傳回一個 CardCard 構成首頁的 物件首頁觸發函式的 事件物件 做為參數,其中包含一些一般資訊,例如客戶的 平台。您可以使用事件物件資料,自訂 首頁。

擴充日曆活動介面

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敬上 WRITEREAD_WRITE 資訊清單欄位。這也 外掛程式必須具有 https://www.googleapis.com/auth/calendar.addons.current.event.write scope

新增會議解決方案

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