詞彙解釋

這份說明文件使用以下字詞。

日曆會議外掛程式

一種特殊的外掛程式,可讓會議服務供應商在 Google 日曆活動中顯示會議選項。這些外掛程式需要經過完善開發的會議解決方案,才能連線至這些外掛程式。因為這類要求,大多數開發人員都不需要建立 Google 日曆會議外掛程式。

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

資訊卡

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

詳情請參閱「資訊卡」一文。

卡片式

這個外掛程式的使用者介面會顯示為側欄中的窗格 (在行動裝置上,則是透過選單前往的其他活動視窗)。外掛程式會提供頂端工具列,可識別外掛程式並顯示資訊卡 (本質上是外掛程式 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 預覽的網址模式,以及設定預覽內容 (包括智慧型方塊和預覽資訊卡)。連結預覽觸發條件是在外掛程式指令碼專案的資訊清單中設定,因此是資訊清單觸發條件的類型。

詳情請參閱「使用智慧型方塊預覽連結」。

資訊清單

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

資訊清單觸發條件

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

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

非主題資訊卡

當使用者離開特定情境時,資訊卡會顯示內容的資訊卡;例如,在 Gmail 中查看電子郵件討論串,但未開啟使用者時。首頁是與內容無關的資訊卡,

主機 UI 右側的這個部分,顯示 Google Workspace 外掛程式的 UI。也可以定義側欄。

智慧型方塊

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

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

觸發條件

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

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

觸發函式

專案中的 Apps Script 函式,用於回應觸發事件的觸發事件。

小工具

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

詳情請參閱「小工具」一文。

小工具處理常式函式

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

詳情請參閱「小工具處理常式函式」一文。