詞彙解釋

下列字詞用於整個說明文件。

日曆會議外掛程式

這個特殊的外掛程式可讓會議服務供應商在 Google 日曆活動中顯示會議選項。這些外掛程式需要完善的會議解決方案,才能讓外掛程式連線。因此,大部分的開發人員都不需要建立日曆會議外掛程式。

詳情請參閱「日曆會議通訊外掛程式」。另請參閱「升級已發布的外掛程式」,瞭解如何將日曆會議外掛程式轉換為 Google Workspace 外掛程式。

資訊卡

外掛程式 UI 的單一「頁面」。資訊卡由不同的小工具物件 (按鈕、文字欄位、標頭等) 組成。

詳情請參閱資訊卡

卡片式

外掛程式,其使用者介面顯示為側欄中的窗格 (在行動裝置上,在行動裝置上則透過選單前往另一個活動視窗)。外掛程式有一個頂端工具列,可用來識別外掛程式並顯示資訊卡 (通常是外掛程式 UI 的「頁面」)。

Google Workspace 外掛程式屬於卡片性質,

會議資料

Google 日曆需要這組資訊,才能讓使用者建立及加入由 Google Workspace 外掛程式或日曆會議外掛程式啟用的第三方會議。

詳情請參閱會議資料一文。

會議解決方案

代表可使用 Google Workspace 外掛程式或日曆會議外掛程式透過 Google 日曆建立的第三方會議。

詳情請參閱會議解決方案

內容脈絡

主機應用程式目前的狀態。舉例來說,哪些郵件目前在 Gmail 中開啟、您正在編輯哪些日曆活動,或您選取的雲端硬碟檔案屬於主機應用程式的當前內容。背景資訊和其他資訊則會收集到事件物件中,並以參數的形式傳遞至觸發條件函式。

內容比對觸發

定義在使用者輸入特定情境 (例如在 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 中預覽的網址模式,並設定預覽內容,包括智慧型方塊和預覽資訊卡。連結預覽觸發條件是在外掛程式指令碼專案的資訊清單中設定,因此是資訊清單觸發條件的類型。

詳情請參閱「在 Google 文件中預覽連結」。

資訊清單

附加至 Apps Script 專案的 JSON 檔案。資訊清單可用來定義指令碼必須正確執行的專案資訊。針對 Google Workspace 外掛程式,資訊清單是用來指定外掛程式可擴充的主機,並提供特定的 UI 控制項設定。

資訊清單觸發條件

在專案資訊清單中定義的觸發條件,例如首頁觸發條件或內容相關觸發條件。資訊清單觸發條件只會用於在要求外掛程式首頁或外掛程式輸入需要更新螢幕的內容時建立及顯示新資訊卡。

資訊清單觸發條件與 Apps Script 中的其他觸發條件不同,因為這類觸發條件不內建 (例如簡易觸發條件),且無法使用 Apps Script 指令碼服務 (例如可安裝的觸發條件) 透過程式建立。

非內容資訊卡

當使用者不在特定情境時,資訊卡會顯示內容;例如在 Gmail 中檢視電子郵件會話串,但未開啟任何資訊卡。首頁是一種非內容資訊卡,

主機 UI 右側會顯示 Google Workspace 外掛程式 UI 的部分。Gmail 和編輯器外掛程式也可以定義側欄。

智慧型方塊

智慧型方塊是指 Google Workspace 應用程式內的使用者、檔案、日曆活動或其他實體。當使用者將滑鼠遊標懸停在方塊上時,也可以預覽檔案或連結的其他內容。舉例來說,當使用者將遊標懸停在 Google 簡報方塊上時,他們會看見投影片的螢幕截圖、簡報的擁有者,以及他們是否曾經檢視過簡報。

您可以設定外掛程式,以便使用智慧型方塊預覽第三方或非 Google 服務的連結。請參閱在 Google 文件中預覽連結

觸發條件

由 Apps Script 專案或外掛程式定義的條件和自動事件回應。相關事件發生時 (例如外掛程式開啟時),就會觸發觸發條件,並導致指定的 Apps Script 函式 (觸發條件函式) 自動執行。針對 Google Workspace 外掛程式,觸發條件函式通常會建構新的資訊卡,以便控制外掛程式 UI 的顯示部分。只有特定事件類型可以使用觸發條件。

詳情請參閱「外掛程式觸發條件」一節。

觸發函式

專案中的 Apps Script 函式,此函式為了回應觸發的觸發條件而執行。

小工具

UI 元素,例如按鈕、文字欄位或核取方塊。資訊卡是由一系列小工具物件所建構,由 Apps Script 內建的卡片服務定義。

詳情請參閱「小工具」。

小工具處理常式函式

將特定小工具連結至特定動作物件的函式。每個小工具類型都有一組定義的小工具處理常式函式,可用來連結動作。小工具操作函式會定義何種使用者互動會觸發產生的動作,也是小工具互動的重要元件。

詳情請參閱小工具處理常式函式