安裝並授權外掛程式

使用者必須安裝並授權外掛程式,才能開啟及使用。由於這些步驟是外掛程式使用者體驗的第一部分,因此建議您先瞭解這些步驟,再開始建立自己的外掛程式。

本說明文件章節會說明使用者如何安裝、授權以及開始使用外掛程式。

安裝外掛程式

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

您可以從 Google Workspace 主機應用程式或 Google Workspace Marketplace 安裝已發布的外掛程式。網域管理員也可以代表使用者從 Google Workspace Marketplace 安裝外掛程式。您也可以安裝正在開發的未發布的外掛程式,以便進行測試。首次使用已安裝的外掛程式前,您必須先授權該外掛程式。

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

授權外掛程式

安裝外掛程式後,新的外掛程式就會顯示在其擴充的 Google Workspace 主機應用程式中。使用者首次嘗試使用主機應用程式時,系統會向使用者顯示授權資訊卡或對話方塊。這張資訊卡說明外掛程式需要使用者執行的操作,例如存取目前 Google 試算表的內容。接著,使用者就能授予這些權限,並允許外掛程式繼續操作。如果使用者拒絕外掛程式授權,就無法使用外掛程式。

編輯器外掛程式使用的授權模型與 Google Workspace 外掛程式不同。由於編輯器外掛程式是在 Google 雲端硬碟檔案中運作,編輯器授權模型會定義各種授權模式,在將外掛程式與個別檔案搭配使用時會產生結果。開發編輯器外掛程式時,請務必瞭解各種模式,以及外掛程式在兩者間移動的方式。

授權已發布的外掛程式

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

  1. 系統會提示您選擇帳戶,以便安裝外掛程式。
  2. 接著,系統會提供您執行外掛程式所需的授權清單,讓您瞭解該外掛程式要執行的操作。請詳閱這份清單,如果您仍然要授予權限,請按一下「Allow」。這樣即可啟用外掛程式。
  3. 您現在可以從擴充的主機應用程式執行這個程式庫。如果應用程式已在瀏覽器分頁中開啟,您可能需要重新整理分頁,才能使用外掛程式。

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

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

外掛程式授權卡

取消發布的外掛程式與已發布的外掛程式沒有相同的授權流程,因為尚未列在 Google Workspace Marketplace 中。安裝取消發布的外掛程式後,系統不會立即要求您授權。相反地,授權流程會在您初次使用外掛程式時啟動。

外掛程式在執行時,可判斷是否需要任何使用者授權。在需要授權的情況下,外掛程式會顯示授權資訊卡。首次執行外掛程式時,一律需要授權,如果外掛程式的新版本使用了先前未獲授權的服務,則可能需要授權。「Authorize Access」(授權存取) 按鈕提供對話方塊視窗,讓使用者可以對外掛程式允許或拒絕授權。

授權 Google Workspace 外掛程式的非 Google 服務

Google Workspace 外掛程式有可能連結至本身需要授權的第三方服務。如要連結至這類服務,使用者需要採取兩項不同操作:

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

如果您開發的 Google Workspace 外掛程式需要使用 OAuth 存取非 Google 服務,則您必須在建構外掛程式時為該服務設定連線。

詳情請參閱「將 Google Workspace 外掛程式連結至第三方服務」一文。

第三方會議系統

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

如果使用者嘗試透過外掛程式建立會議而不需要登入,則會議解決方案的 onCreateFunction 方法應傳回包含 ConferenceError驗證網址ConferenceData 物件。

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

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

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

建議您在開發編輯器外掛程式時測試編輯器外掛程式。授權流程與已發布的編輯器外掛程式相同,唯一差別在於首次嘗試測試外掛程式時就會啟動。如果您之後重新測試相同外掛程式,系統就不會再次提示您授權。

取消授權外掛程式

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

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

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

若您在取消授權後再次執行外掛程式,會再次顯示授權流程。