升級舊版 Gmail 和日曆外掛程式

如果您已經打造並發布外掛程式 來擴充 Gmail 或 Google 日曆 升級至 Google Workspace 外掛程式本頁的操作說明將詳細說明如何 ,讓你為現有的 Gmail 或日曆外掛程式新增 Google Workspace 功能,以及 然後發布升級版外掛程式,讓使用者更容易找到及安裝

您可以將新功能轉移到 來保留您的 Google Workspace Marketplace 清單、安裝項目和使用者。 升級後還可享有全新的 Google Workspace 外掛程式功能 例如首頁

步驟 1:複製外掛程式的 Apps Script 專案

升級的外掛程式使用與已發布的外掛程式相同的 Google Cloud 專案 外掛程式,但請務必建立和使用基礎應用程式副本 指令碼專案,確保現有使用者不會受到測試期間的影響 升級版本一併升級原始指令碼專案副本 這表示您隨時可以存取原始程式碼,如果日後需要重新部署, 無從得知

  1. 開啟現有的 Gmail 外掛程式或日曆會議外掛程式 Apps Script 專案。
  2. 按一下左側的「總覽」
  3. 按一下右側的「建立副本」圖示
  4. 按一下左側的「專案設定」>變更專案
  5. 按一下「GCP 專案編號」
  6. 請輸入相同的 專案編號 與您已發布的 Apps Script 外掛程式建立關聯。
  7. 按一下「設定專案」
,瞭解如何調查及移除這項存取權。

步驟 2:整合 Google Workspace 外掛程式

您必須設計並實作任何想新增的 Google Workspace 外掛程式功能 您的外掛程式。

  1. 規劃要在外掛程式中顯示的內容 首頁資訊卡 會出現在 Gmail、日曆、雲端硬碟,或者是這三項條件的任意組合 主機。如果您希望透過多個主機設定首頁,需決定是否啟用首頁 可以位於同一個首頁,或是您希望每個主機自訂首頁資訊卡。
  2. 在複製的 Apps Script 專案中建立首頁 具有 homepageTrigger 的資訊卡 函式。請務必加入 控制新版首頁介面。
  3. 建議新增使用者動作觸發的內容資訊卡,例如開啟 Gmail 郵件串日曆活動

  4. 更新任何對事件物件的存取 (在小工具回呼函式或內容相關觸發條件中) 函式) 使用新版 事件物件結構。 新結構仍包含 Gmail 和 Google 日曆會議通訊外掛程式,但原始欄位為 且最終將會移除

步驟 3:更新外掛程式的資訊清單

設定資訊儲存在 資訊清單結構 Google Workspace 外掛程式與 Gmail 外掛程式的結構截然不同 和日曆會議外掛程式升級外掛程式時,您必須根據外掛程式,更新外掛程式的 Apps Script 專案資訊清單欄位 下方表格。請務必將所有相關子資源更新為新的 addOns 資源。

此外,請務必更新資訊清單的 oauthScopes 欄位做為 以反映更新後的外掛程式所需權限。

如要進一步瞭解 Google Workspace 外掛程式資訊清單, 請參閱資訊清單

Gmail 外掛程式

原始資訊清單欄位 需採取行動
gmail.composeTrigger 移至 addOns.gmail.composeTrigger
gmail.contextualTriggers[] 將清單移至 addOns.gmail.contextualTriggers[]
gmail.logoUrl 移至 addOns.common.logoUrl
gmail.name 移至 addOns.common.name
gmail.openLinkUrlPrefixes[] 將清單移至 addOns.common.openLinkUrlPrefixes[]
gmail.primaryColor 移至 addOns.common.layoutProperties.primaryColor
gmail.secondaryColor 移至 addOns.common.layoutProperties.secondaryColor
gmail.universalActions[] 將清單移至 addOns.common.universalActions[]
gmail.universalActions[].text 將每個 gmail.universalActions[].text 欄位移至 對應addOns.common.universalActions[].label ] 欄位。
gmail.useLocalFromApp 移至 addOns.common.useLocaleFromApp

Google 日曆會議外掛程式

原始資訊清單欄位 需採取行動
calendar.createSettingsUrlFunction 移至 addOns.calendar.createSettingsUrlFunction
calendar.conferenceSolution[] 移至 addOns.calendar.conferenceSolution[]
calendar.logoUrl 移至 addOns.common.logoUrl
calendar.name 移至 addOns.common.name

步驟 4:測試升級版外掛程式

如要在發布前測試升級版外掛程式,請按照下列步驟操作: 請參閱「測試 Google Workspace 外掛程式」。

步驟 5:針對已升級的外掛程式提出審查申請

所有 Google Workspace 外掛程式,無論是升級版外掛程式,還是從頭開始建構的外掛程式。 必須經過核准,才能在 Google Workspace Marketplace 上架。

請按照下列步驟將外掛程式送交審查:

  1. 請確認外掛程式符合 外掛程式發布規定

  2. 建立版本化部署作業 的 Google Workspace 外掛程式 (在新的 Apps Script 專案中),新版 要發布的程式碼請勿嘗試使用 Head 發布 可能面臨擴充性、監控、持續整合 和部署等方面的挑戰

  3. 如果您在升級外掛程式時新增了範圍,則必須 要求 OAuth 驗證。 舉例來說,如果您的 Gmail 外掛程式在 Google Workspace 外掛程式版本,您必須提交這些新範圍以供驗證。 驗證程序通常會在幾天內完成,因此請先按照 越早越好請先確認外掛程式已通過驗證,再繼續操作 至步驟 6:

步驟 6:啟用升級版外掛程式

  1. 開啟 Google Workspace Marketplace SDK。

  2. 按一下左側的「設定」。這個面板會提供一份表單 提供外掛程式的相關資訊。

  3. 更新應用程式的簡短說明、詳細說明和螢幕截圖 。

  4. 在「擴充功能」擴充功能下方,點選升級至 Google Workspace 外掛程式按鈕。 在隨即顯示的文字方塊中,輸入您建立的新部署作業 ID。 您的 Google Workspace 外掛程式。如果部署作業 ID 有效, 隨即顯示支援的主機清單。

  5. 如果您在 Google Workspace 外掛程式中新增了範圍,請務必將這些範圍新增至 「設定」頁面中的「OAuth 2.0 範圍」部分。這個清單列出的範圍 該部分所列的範圍,必須與外掛程式 資訊清單。

  6. 確認你在表單中輸入的資訊正確無誤。接著: 按一下「儲存變更」

這項 Google Workspace 外掛程式升級期間有任何疑問或遇到問題 請與我們聯絡

常見問題

以下是關於外掛程式升級的常見問題:

我可以升級編輯器外掛程式嗎?

大多數的編輯器外掛程式都可以移至 Google Workspace 外掛程式。不過無法 升級至 Google Workspace 外掛程式,就像在 Gmail 和 日曆。

如果想將編輯器外掛程式遷移至 Google Workspace 外掛程式,您需要 將外掛程式的使用者介面從 HTML 改寫為卡片式 介面,並更新 JavaScript 卡片服務的結果。

現有編輯器外掛程式中的部分服務可能無法在 卡片服務。舉例來說,如果您的編輯器外掛程式內含檔案選擇器 此優惠未提供「Google Workspace 外掛程式卡服務」提供的同等項目。

我可以另外建立 Google Workspace 外掛程式並繼續使用現有外掛程式嗎?

歡迎以不同品牌名稱建立其他 Google Workspace 外掛程式 ,但我們不允許在 品牌名稱。如有任何疑問或想要求我們協助 如有需要,請與我們聯絡

外掛程式升級後,使用者是否需要重新授權?

只要 Google Workspace 外掛程式 Cloud Platform (GCP) 專案, 與相關聯的 OAuth 用戶端 ID 建立關聯,使用者就不需要重新授權。 授予原始外掛程式的權限。不過, 如果您在升級程序期間新增範圍,則使用者必須對這些範圍進行授權 首次使用 Google Workspace 時的新範圍 以及外掛程式版本

我可以將 Chrome 擴充功能升級至 Google Workspace 外掛程式並轉移使用者嗎?

不可以。您無法轉移 Chrome 擴充功能的使用者、安裝和商店資訊 評論。您必須建立新的 Google Workspace 外掛程式,並引導 Chrome 使用者 Google Workspace Marketplace 的擴充功能

我可以將多個外掛程式與 Google Workspace 外掛程式搭配使用嗎?

請參閱「一併列出應用程式整合作業」。