安裝並授權外掛程式

使用者必須安裝並授權外掛程式, 可以開啟及使用由於這些步驟是 以及額外使用者體驗 再開始建立自己的外掛程式

本文件將說明使用者如何安裝、授權及 即可開始使用外掛程式

安裝外掛程式

您必須先安裝外掛程式,才能使用外掛程式。 安裝完成後,該外掛程式就會顯示在 Google Workspace 託管應用程式 持續擴充

如要安裝已發布的外掛程式,請前往 或從 Google Workspace 安裝的 Google Workspace Marketplace。 網域管理員也可以代表使用者從 Google Workspace Marketplace 安裝外掛程式。你也可以 安裝尚未發布的外掛程式 以及開發和測試安裝前 外掛程式,首先您必須 授權 基礎架構

詳情請參閱「發布外掛程式」。

授權外掛程式

安裝後, Google Workspace 託管應用程式 持續擴充使用者第一次嘗試使用 外掛程式,就會以 授權資訊卡或對話方塊這張資訊卡說明 外掛程式需要使用者執行相關作業的權限,例如 存取目前 Google 試算表的內容。使用者可以授予這些權限,讓外掛程式繼續執行。如果 使用者拒絕外掛程式 授權,因此無法使用外掛程式。

編輯器外掛程式使用的授權模式與 Google Workspace 外掛程式不同。由於編輯器外掛程式會在 Google 雲端硬碟檔案上運作,因此編輯器授權模式會定義各種授權模式,這些模式會在使用外掛程式與個別檔案時產生。開發編輯器外掛程式時,請務必瞭解不同的模式,以及外掛程式在不同模式之間的移動方式。

授權已發布的外掛程式

安裝已發布的外掛程式後,授權流程會立即開始:

  1. 系統會提示你選擇要安裝外掛程式的帳戶
  2. 接著,系統會顯示外掛程式運作所需的授權清單,讓您瞭解外掛程式嘗試執行的動作。請仔細查看這份清單,如果仍要授予授權,請按一下「允許」。這樣就能啟用外掛程式。
  3. 您現在可以前往 託管應用程式 持續擴充如果應用程式已在瀏覽器分頁中開啟,您可能需要重新整理分頁,才能使用外掛程式。

如果您安裝的外掛程式日後更新,並需要您尚未授予的額外授權,系統會在您下次使用外掛程式時,提示您提供這些權限。

授權未發布的 Google Workspace 外掛程式

外掛程式授權卡

取消發布的外掛程式與已發布外掛程式沒有相同的授權流程 ,因為這些應用程式尚未列在 Google Workspace Marketplace 中。安裝未發布的外掛程式後,系統不會立即要求您授權。改為授權流程 會在您首次嘗試使用外掛程式時開始計算。

外掛程式在執行時,可判斷是否需要任何使用者授權。如果 在需要授權時,外掛程式會顯示授權卡。 首次執行外掛程式時,一律需要授權,也可能 如果外掛程式的新版本使用先前從未使用的服務,則此為必填欄位 已獲得授權「Authorize Access」按鈕會顯示對話方塊,讓使用者允許或拒絕外掛程式授權。

授權 Google Workspace 外掛程式使用非 Google 服務

Google Workspace 外掛程式可以連線至需要授權的第三方服務。連結至這類服務的 Google Workspace 外掛程式需要使用者執行兩項不同的動作:

  • 在安裝或首次啟動外掛程式時,授權外掛程式本身。
  • 首次存取非 Google 服務時的授權。

如果 Google Workspace 外掛程式正在開發相關需求 如要透過 OAuth 存取非 Google 服務,您必須 設定連線 為該服務建立外掛程式

如需更多資訊,請參閱 將 Google Workspace 外掛程式連結至第三方服務

第三方會議系統

擴充 Google 日曆的 Google Workspace 外掛程式也可以新增其他會議解決方案,讓使用者在編輯 Google 日曆活動時選取第三方會議系統。如果您的外掛程式提供需要使用者登入的會議選項,則必須讓使用者能夠登入。

如果使用者嘗試透過外掛程式建立會議,但未完成必要的登入程序,會議解決方案的 onCreateFunction 方法 應會傳回 ConferenceData 物件,其中包含含有驗證網址ConferenceError

收到這個物件後,Google 日曆會在登入 活動編輯使用者介面,連結至外掛程式提供的驗證網址。 使用者可以使用這個按鈕登入第三方系統,再進一步使用外掛程式。

如要進一步瞭解如何使用 ConferenceError 處理授權,請參閱「建立第三方會議」。

授權未發布的編輯器外掛程式

最佳做法是在開發時測試編輯器外掛程式。授權流程與已發布的編輯器外掛程式相同,唯一差別是流程會在您首次嘗試測試外掛程式時啟動。如果日後重新測試相同的擴充功能,系統就不會再要求您授權。

取消授權外掛程式

建議您取消授權,以便重新測試自己開發的外掛程式 授權流程

如要取消授權外掛程式,請按照下列步驟操作:

  1. 開啟帳戶安全性控制台
  2. 找出並按一下要取消授權的外掛程式。
  3. 按一下「移除存取權」

取消授權後再次執行外掛程式時,系統會再次顯示授權流程。

解除安裝外掛程式

如要解除安裝從 Google Workspace Marketplace 安裝的外掛程式,請參閱「解除安裝 Marketplace 中的應用程式或外掛程式」。

如要解除安裝 Apps Script 中未發布的外掛程式,請參閱「解除安裝未發布的外掛程式」。