詞彙解釋

本說明文件會使用下列術語。

日曆會議外掛程式

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

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

資訊卡

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

詳情請參閱「資訊卡」。

卡片式

使用者介面會以窗格形式顯示在側欄。但如果是在行動裝置上,只能以另一個活動視窗出現,使用者需透過選單才能存取。外掛程式的頂端工具列可辨識外掛程式,並顯示資訊卡,這可以說是外掛程式 UI 的「頁面」。

Google Workspace 外掛程式是以資訊卡為基礎。

會議資料

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

詳情請參閱「會議資料」。

會議解決方案

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

詳情請參閱「會議解決方案」。

背景資訊

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

內容比對觸發

定義觸發條件的做法,當使用者進入特定情境時 (例如在 Gmail 中開啟電子郵件串),就會觸發條件。透過情境式觸發,外掛程式可提供與該情境相關的使用者介面。外掛程式指令碼專案的資訊清單中會設定情境觸發條件,因此這類觸發條件屬於資訊清單觸發條件

編輯器外掛程式

原始外掛程式類型僅允許擴充 Google 文件、試算表、表單或簡報。編輯器外掛程式並非以資訊卡為基礎,而是需要開發人員以原始 HTML 和 CSS 建立 UI。每個編輯器外掛程式只能擴充一個主機應用程式。

詳情請參閱「編輯器外掛程式」。

Event 物件

在要求首頁、外掛程式進入需要回應的環境,或是使用者與外掛程式介面中的小工具互動時,系統會自動建立 JSON 物件。建立事件物件後,系統會將這些物件傳遞至指定的觸發函式或回呼函式。事件物件的用途是將資訊從使用者用戶端環境 (例如使用者在外掛程式介面小工具中輸入的資訊) 傳遞至外掛程式的伺服器端程式碼,然後伺服器端程式碼就能根據該資訊採取行動,並傳回適當的回應。

詳情請參閱「事件物件」。

Gmail 外掛程式

這類外掛程式只能擴充 Gmail 功能。Gmail 外掛程式是以卡片為基礎,用於建立 Gmail 外掛程式的功能、行為和開發詳細資料,與用於建立 Google Workspace 外掛程式的詳細資料相同。

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

首頁

外掛程式的根層級 UI 資訊卡。使用者開啟外掛程式時會看到首頁,外掛程式可藉此顯示特定情境以外的內容 (例如使用者在 Gmail 中查看電子郵件串,但尚未開啟任何郵件)。您可以定義外掛程式首頁的外觀和行為,就像其他資訊卡一樣。

詳情請參閱「首頁」。

主機或主機應用程式

Google Workspace 應用程式會擴充 Google Workspace 外掛程式,例如 Gmail 或 Google 日曆。

以 HTML 為基礎

這類外掛程式的使用者介面是使用 HTML 和 CSS 定義,而非 Apps Script 內建的資訊卡服務。只有舊版 Google 編輯器外掛程式是以 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 內建的 Card 服務定義。

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

小工具處理常式函式

這個函式會將特定小工具連結至特定動作物件。每個小工具類型都有一組已定義的小工具處理常式函式,可用於連結至動作。小工具處理常式函式會定義觸發後續動作的使用者互動類型,是小工具互動性的重要元件。

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