以下術語會在本說明文件中使用。
Google 日曆會議外掛程式
一種特殊的外掛程式,可讓會議供應商在 Google 日曆活動中提供會議選項。這些外掛程式需要完善的會議通訊解決方案才能連線。由於這項規定,大多數開發人員都不需要建立日曆會議加購項目。
詳情請參閱「Google 日曆會議外掛程式」。如要進一步瞭解如何將 Google 日曆會議外掛程式轉換為 Google Workspace 外掛程式,請參閱「升級已發布的外掛程式」。
資訊卡
外掛程式 UI 的單一「頁面」。資訊卡由不同的小工具物件 (按鈕、文字欄位、標頭等) 組成。
詳情請參閱「資訊卡」。
以資訊卡為基礎
使用者介面會顯示在側欄的面板中 (在行動裝置上,則會顯示為透過選單存取的另一個活動視窗)。附加元件會在頂端顯示可識別附加元件的工具列,並顯示資訊卡,這基本上是附加元件 UI 的「頁面」。
Google Workspace 外掛程式是以資訊卡為基礎。
會議資料
Google 日曆需要的資訊集合,可讓使用者建立及加入由 Google Workspace 外掛程式或日曆會議通訊外掛程式啟用的第三方會議。
詳情請參閱「會議資料」。
會議解決方案
第三方會議的表示法,可透過 Google Workspace 外掛程式或 Google 日曆會議外掛程式,從 Google 日曆建立。
詳情請參閱會議解決方案。
背景資訊
主機應用程式的目前狀態。舉例來說,目前在 Gmail 中開啟的郵件、您正在編輯的日曆活動,或是您選取的 Google 雲端硬碟檔案,都屬於主機應用程式目前的內容。系統會將內容與其他資訊收集到事件物件中,並以參數的形式傳遞至觸發事件函式。
內容觸發
定義觸發條件,在使用者進入特定情境時觸發,例如在 Gmail 中開啟電子郵件會話串。觸發條件可讓外掛程式提供與該情境相關的 UI。情境觸發事件是在外掛程式指令碼專案的資訊清單中設定,因此屬於資訊清單觸發事件的一種。
編輯器外掛程式
原始的外掛程式類型組合,僅允許 Google 文件、試算表、表單或簡報的擴充功能。編輯器外掛程式並非以卡片為基礎,而是要求開發人員使用原始 HTML 和 CSS 建立 UI。每個編輯器外掛程式只能擴充一個主機應用程式。
詳情請參閱「編輯器外掛程式」。
事件物件
在要求首頁、外掛程式進入需要回應的情況,或使用者與外掛程式介面中的小工具互動時,系統會自動建立 JSON 物件。建立後,事件物件會傳遞至指定的觸發函式或回呼函式。事件物件的目的是將資訊從使用者的用戶端環境 (例如他們輸入至外掛程式介面小工具的資訊) 傳送至外掛程式的伺服器端程式碼,以便後者根據該資訊採取行動,並傳回適當的回應。
詳情請參閱「事件物件」。
Gmail 外掛程式
僅擴充 Gmail 功能的擴充功能。Gmail 外掛程式是建立在資訊卡的基礎上。建立 Gmail 外掛程式時使用的大部分功能、行為和開發詳細資料,都與建立 Google Workspace 外掛程式時使用的相同。
詳情請參閱「Gmail 外掛程式」。如要瞭解如何將 Gmail 外掛程式轉換為 Google Workspace 外掛程式,請參閱升級已發布的外掛程式。
首頁
外掛程式的根 UI 資訊卡。使用者開啟外掛程式時會顯示主畫面,讓外掛程式在特定情境之外顯示內容 (例如使用者在 Gmail 中查看電子郵件會話串,但尚未開啟任何會話串)。您可以像其他資訊卡一樣,定義外掛程式首頁的外觀和行為。
詳情請參閱首頁。
主機或主機應用程式
Google Workspace 外掛程式擴充的 Google Workspace 應用程式,例如 Gmail 或 Google 日曆。
以 HTML 為基礎
使用 HTML 和 CSS 定義使用者介面,而非使用 Apps Script 內建的卡片服務。只有較舊的編輯器外掛程式是基於 HTML。
連結預覽觸發條件
當使用者在 Google 主機應用程式 (例如 Google 文件) 中與第三方或非 Google 網址互動時,連結預覽功能就會觸發。連結預覽觸發事件可讓您定義網址模式,以便從服務或 API 預覽,並設定預覽內容,包括智慧方塊和預覽資訊卡。連結預覽觸發事件是在外掛程式專案的資訊清單中設定,因此屬於一種資訊清單觸發事件。
詳情請參閱「使用智慧型方塊預覽連結」。
資訊清單
附加至 Apps Script 專案的 JSON 檔案。資訊清單用於定義指令碼需要正確執行的專案資訊。針對 Google Workspace 外掛程式,資訊清單用於指定外掛程式可延伸的代管服務器,並提供特定 UI 控制項設定。
資訊清單觸發條件
在專案資訊清單中定義的觸發條件,例如首頁觸發條件或內容觸發條件。資訊清單觸發事件專門用於在要求外掛程式首頁或外掛程式進入需要顯示更新的情況下,建立及顯示新資訊卡。
資訊清單觸發事件與 Apps Script 中的其他觸發事件不同,因為它們不是內建的 (例如簡易觸發事件),也無法透過程式設計使用 Apps Script Script 服務建立 (例如可安裝的觸發事件)。
非情境卡片
當使用者處於特定情境之外時,顯示內容的資訊卡,例如在 Gmail 中查看電子郵件會話串,但尚未開啟任何會話串。首頁是一種非情境資訊卡。
側欄
主機 UI 右側的部分,Google Workspace 外掛程式的 UI 會顯示在此處。Gmail 和編輯器外掛程式也可以定義側欄。
智慧型方塊
智慧型方塊是指在 Google Workspace 應用程式中提及的使用者、檔案、日曆活動或其他實體。使用者將游標懸停在方塊上時,也可以預覽檔案或連結的其他內容。舉例來說,當使用者將滑鼠游標懸停在 Google 簡報的方塊上時,會看到簡報的螢幕截圖、簡報擁有者,以及使用者是否曾查看過該簡報。
您可以設定外掛程式,使用智慧型方塊預覽第三方或非 Google 服務的連結。請參閱「在 Google 文件中預覽連結」。
觸發條件
由 Apps Script 專案或外掛程式定義的條件和自動事件回應。觸發事件會在相關聯的事件發生時觸發 (例如開啟外掛程式),並導致指定的 Apps Script 函式 (觸發事件函式) 自動執行。針對 Google Workspace 外掛程式,觸發函式通常會建立新的資訊卡,以便控制要顯示哪些部分的附加元件 UI。只有特定事件類型可以設定觸發條件。
詳情請參閱外掛觸發條件。
觸發函式
專案中的 Apps Script 函式,會在觸發事件觸發時執行。
小工具
UI 元素,例如按鈕、文字欄位或核取方塊。卡片是由一系列小工具物件組成,這些物件是由 Apps Script 內建的卡片服務定義。
詳情請參閱「小工具」。
小工具處理常式函式
這個函式可將特定小工具連結至特定動作物件。每個小工具類型都有一組定義的小工具處理常式函式,可用於連結至動作。小工具處理常式函式會定義哪種使用者互動會觸發產生的動作,也是小工具互動性的關鍵元件。
詳情請參閱「小工具處理常式函式」。