Google Workspace 外掛程式可以提供自訂 介面。 如此一來,您便能為使用者提供其他相關資訊, 工作,以及將第三方系統連結至 Google 日曆。
建立 Google 日曆外掛程式介面時,您可以提供 首頁。您也可以使用相同的 首頁提供多個主辦人的首頁,或是為 Google 日曆設計專屬網站。
您的外掛程式也可以定義 日曆活動。
存取外掛程式 UI
視開啟方式而定,Google Workspace 外掛程式可以定義首頁介面、Google 日曆活動介面、附件選取介面,或同時定義全部三種:
- 如果使用者在日曆檢視畫面中點選外掛程式圖示,外掛程式就會執行
相應的
calendar.homepageTrigger
函數 (如果有的話)。這個函式會建立並傳回首頁資訊卡 改為顯示在日曆上如果答案為「否」calendar.homepageTrigger
函式,將改為顯示一般首頁資訊卡。 - 如果使用者開啟日曆活動後按一下外掛程式圖示,
這個外掛程式會在使用者開啟事件時開啟
就會執行相應的
eventOpenTrigger
函數 (如果有的話)。這個函式會建立外掛程式的日曆活動 介面並傳回「Google 日曆」以顯示內容。 - 如果外掛程式定義了
eventAttachmentTrigger
函式, 如果使用者在編輯日曆活動時點選「新增附件」,這個外掛程式就會顯示為附件提供者。選取外掛程式後eventAttachmentTrigger
函式會建立外掛程式附件 選取介面並傳回「Google 日曆」即可顯示內容。
建構外掛程式的日曆介面
你可以透過 Google Workspace 外掛程式的步驟如下:
- 決定您是否希望外掛程式具有 Google 日曆專用的功能 首頁。 另外再決定是否要提供自訂介面 編輯日曆活動。
- 新增適當的
addOns.common
和addOns.calendar
新增至外掛程式指令碼專案資訊清單的欄位 包括任何所需的範圍。 - 如果您要提供日曆專用的
homepage
實作
calendar.homepageTrigger
函式來建構這個介面。您也可以選擇使用common.homepageTrigger
顯示多名 Google Workspace 主機的介面。 - 如果要提供「日曆活動」介面,則必須實作
calendar.eventOpenTrigger
函式來建構這個介面。詳情請見 擴充日曆活動介面 。 - 實作回應使用者的回呼所需的關聯回呼函式 使用者介面互動,例如按鈕點擊。
日曆首頁
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 extension;新增的解決方案會顯示為選項 Google 日曆活動 UI。