本頁說明如何使用 Google Workspace Marketplace SDK，在 Google Workspace Marketplace 中設定及管理應用程式。
如要開放使用應用程式，請在 Marketplace SDK 中設定。Marketplace SDK 是一套工具包，可讓您在 Marketplace 中建立及控管應用程式。您可以使用 Marketplace SDK 管理 Marketplace 設定，例如：
- 應用程式是僅供特定 Google Workspace 機構使用 (私人應用程式)，還是開放所有 Marketplace 使用者使用 (公開應用程式)
- 可安裝您應用程式的 Marketplace 使用者類型
- 應用程式整合的 Google Workspace 應用程式
- 應用程式所需的 OAuth 範圍
- 建構及維護應用程式的人員相關資訊
無論您是發布私人或公開應用程式，都必須使用 Marketplace SDK 在 Marketplace 上管理應用程式。
啟用 Marketplace SDK
如果尚未啟用，請在 Google Cloud 雲端專案中啟用 Marketplace SDK。
在 Google Cloud 控制台中開啟雲端專案
如果尚未開啟，請開啟要用於這個範例的雲端專案：
- 前往 Google Cloud 控制台的「選取專案」頁面。
- 選取要使用的 Google Cloud 專案。或者，按一下「建立專案」，然後按照畫面上的指示操作。建立 Google Cloud 專案後，您可能需要為專案啟用計費功能。
開啟 Marketplace SDK
使用 Google API 前，您需要在 Google Cloud 專案中啟用這些 API。 您可以在單一 Google Cloud 專案中啟用一或多個 API。在 Google Cloud 控制台中啟用 Google Workspace Marketplace SDK。
決定應用程式的設定
下文說明 Marketplace SDK「應用程式設定」頁面提供的設定。
選擇誰可以查看及安裝您的應用程式
設定應用程式時，您可以使用下列設定指定可存取應用程式的使用者：
- 應用程式顯示設定：如果您要在 Google Workspace 機構內發布應用程式，請選擇應用程式資訊是否要設為不公開、僅供機構內使用者查看，或是開放給所有 Google Workspace 使用者。
- 安裝設定：應用程式是否只能由 Google Workspace 管理員安裝。
無論您在應用程式資訊中指定哪些設定，Google Workspace 機構的使用者都可能無法根據管理員設定，探索、安裝或使用您的應用程式。管理員可以透過下列方式影響應用程式的適用情形：
- 控管使用者能否在 Marketplace 中查看應用程式，以及能否代表使用者安裝應用程式。
- 使用許可清單管理及精選貴機構的應用程式。如果您為使用許可清單的機構開發應用程式，請洽詢管理員，瞭解如何將應用程式加入許可清單。
- 關閉特定 Google Workspace 應用程式，例如移除 Google Chat、Google Chat 應用程式或兩者的存取權。在這種情況下，使用者無法從 Marketplace 安裝您的應用程式。
如要瞭解管理員如何管理 Marketplace 存取權，請參閱 Marketplace 管理員說明文件。
應用程式顯示設定
如果您使用 Google Workspace 帳戶 (由公司或學校機構建立的帳戶)，系統會顯示「應用程式顯示設定」選項。如果您使用個人帳戶 (結尾為「@gmail.com」的帳戶)，只能公開發布。
- 公開：網域外部使用者可以找到並安裝應用程式。如果選擇公開顯示，Google 會先審查並核准應用程式資訊，再發布應用程式。
- 私人：只有網域內的使用者可以找到並安裝應用程式。
如果選擇以「不公開」發布，應用程式資訊就不會顯示在瀏覽或搜尋結果中。使用者只能透過直接網址存取應用程式的商店頁面。
如要限制應用程式的適用國家/地區，請在建立商店資訊時，於「發行」部分進行設定。
應用程式安裝設定
「安裝設定」選項可決定使用者或 Google Workspace 管理員能否從 Marketplace 的商店資訊頁面安裝您的應用程式。
- 個人 + 管理員安裝 (預設)：個人使用者可以安裝應用程式，管理員也可以為網域、組織單位或使用者群組安裝應用程式。即使已啟用個別安裝功能，使用者網域政策仍可能禁止使用者安裝應用程式。
- 僅限管理員安裝：只有管理員才能為網域、組織單位或使用者群組安裝應用程式。只有管理員和未登入 Google 帳戶的使用者，才能在 Google Workspace Marketplace 搜尋結果中看到您的應用程式。如果應用程式需要安裝網域，請選擇這個選項。
常見的安裝和瀏覽權限設定
下表概略說明一些常見的應用程式設定選項，包括安裝和顯示設定：
| 應用程式的目標使用者 | 「應用程式顯示設定」設定 | 「應用程式安裝」設定 | 誰可以安裝我的應用程式？ | 誰可以使用我的應用程式？ | |
|---|---|---|---|---|---|
| 為 Google Workspace 機構建構的應用程式 | |||||
| 貴機構的特定使用者 | 私人和不公開 | 個人 + 管理員安裝 | 如果獲得許可，貴機構中知道應用程式資訊網址的任何人。 | 如果獲得許可，貴機構中知道應用程式資訊網址的任何人。 | |
| 貴機構 | 私人 | 個人 + 管理員安裝 | 如果獲得許可，貴機構中的任何使用者都能存取。 | 如果獲得許可，貴機構中的任何使用者都能存取。 | |
| 貴機構 | 私人 | 僅限管理員 | 管理員 | 由管理員安裝應用程式的使用者。 | |
| 適用於特定 Google Workspace 機構以外的使用者 | |||||
| Google Workspace 機構中的使用者 | 公開 | 僅限管理員 | 管理員 | 由管理員安裝應用程式的使用者。 | |
| 所有 Google Workspace 使用者 | 公開 | 個人 + 管理員安裝 |
|
|
|
找出應用程式與 Google Workspace 應用程式的整合方式
「應用程式整合」選項可讓您選擇應用程式或外掛程式要搭配運作的 Google Workspace 服務，例如 Google Workspace 外掛程式或 Google Chat 應用程式。您必須至少選擇一個選項。在某些情況下，您可以在應用程式資訊中加入多個應用程式整合。請參閱「一併列出應用程式整合功能」。
頁面會針對每個 Google Workspace 外掛程式，顯示其支援的每個主機產品發布狀態。這有助於瞭解使用者可用的整合服務。應用程式整合狀態可能如下：
Unsaved：您已新增或修改整合功能，但尚未在「應用程式設定」分頁中儲存變更。Draft：變更已儲存，但尚未發布。Under review：您已提交更新後的應用程式整合內容供審查。Published：應用程式整合功能會納入 Marketplace 資訊。
視所選應用程式整合方式而定，您可能需要提供更多資訊，並在 Google Cloud 專案中啟用相關 API。下表說明各項功能所需的額外設定：
Google Workspace 外掛程式
如要發布 Google Workspace 外掛程式，您必須提供外掛程式的部署作業 ID。
如要在 Apps Script 中找出部署作業 ID，請按照下列步驟操作：
- 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
- 依序點選「部署」> 「管理部署作業」。
- 在部署 ID 下方，按一下「複製」。
如要找出 HTTP 外掛程式的部署 ID，請按照下列步驟操作：
- 在「Google Workspace 外掛程式」下方的「應用程式設定」頁面中，依序按一下「HTTP 或其他部署作業」> 「選取部署作業」。
- 選取要發布的部署作業。
- 按一下「選取」。
編輯器外掛程式 (文件、試算表、簡報、表單)
如要發布編輯器外掛程式，請提供專案指令碼 ID 和要發布的版本。
如要找出專案指令碼 ID，請按照下列步驟操作：
- 在 Apps Script 編輯器中開啟外掛程式。
- 按一下左側的「專案設定」 。
- 在「ID」下方，複製指令碼 ID。
如要查看版本，請按照下列步驟操作：
- 在 Apps Script 編輯器中開啟外掛程式。
- 依序點按右上方的「部署」> 「管理部署作業」。
- 版本號碼會顯示在「設定」下方。
Google Chat 應用程式
如要發布 互動式 Google Chat 應用程式，請參閱下列說明文件：
- 如要在 Chat API 中設定 Chat 應用程式，請參閱「設定 Chat API」。
- 如果您建構的 Chat 擴充應用程式不是 Google Workspace 外掛程式，就必須在 Chat API 中設定互動事件設定。如需步驟，請參閱「接收及回應使用者互動」。
- 如果您使用 AppSheet 的自動設定建構 Chat 應用程式，請按照 AppSheet 文件中的步驟發布 Chat 應用程式，請參閱「使用自動設定共用 Chat 應用程式」。
Google 雲端硬碟應用程式
如要發布雲端硬碟應用程式，您必須啟用並設定 Google Drive API。
網頁應用程式
如要發布網頁應用程式，請提供通用導覽網址，也就是從 Google 應用程式選單 指向網頁應用程式的網址。網頁應用程式必須處於正式版狀態，且功能完備。
填寫商店資訊頁面時，您必須提供大小為 96x96 和 48x48 像素的其他圖示。
如果您是在 Apps Script 中建構網頁應用程式，請按照下列步驟取得通用導覽網址：
- 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
- 依序點選「部署」>「新增部署」 。
- 在「選取類型」下方，按一下「網頁應用程式」。
- 填寫選項，然後按一下「Deploy」(部署)。
- 點選「複製」。
指定應用程式所需的存取層級
在「OAuth 範圍」下方，提供應用程式要求的 OAuth 2.0 範圍完整清單。您在此輸入的 OAuth 範圍應與OAuth 同意畫面顯示的範圍相符，且與 Apps Script 資訊清單 (如適用) 中的範圍相符。
如果加入多個應用程式整合，請務必將每個應用程式的範圍新增至 Marketplace SDK 應用程式設定頁面和 OAuth 同意畫面。
請務必使用最小範圍 (例如，如果只需要唯讀範圍，請勿納入完整的 Google 雲端硬碟範圍)。
如為 Apps Script 專案，詳情請參閱「授權範圍」。
提供應用程式開發人員的相關資訊
在「開發人員資訊」下方，填寫聯絡資訊和其他詳細資料。 這些欄位會顯示在應用程式的商店資訊頁面。
| 欄位 | |
|---|---|
| 交易商狀態 |
根據消費者保護法，我們必須向歐洲經濟區 (EEA) 境內的消費者告知，市集上的商家是交易商還是非交易商：
如果未指定，應用程式的商店資訊頁面會顯示「交易商狀態不明」。 |
| 開發人員名稱 | 顯示為應用程式作者的名稱。如果您是交易人，請提供商業名稱或法定全名。 |
| 開發人員郵寄地址 |
交易者必須提供這項資訊。不會收集非交易商的資料。 商家所在地點。請輸入可聯繫到您的有效郵寄地址。 |
| 開發人員網站網址 | 網站，其中您 (或貴機構) 是開發人員。 |
| 開發人員電子郵件 |
用來做為聯絡窗口的電子郵件地址。不會顯示在應用程式資訊中。請務必提供最新的電子郵件地址，因為系統會使用這個地址：
|
| 應用程式網站網址 | (選用步驟) 進一步說明應用程式的網站。 |
在 Marketplace SDK 中儲存應用程式設定
使用上一節的資訊，在 Marketplace SDK 中儲存應用程式設定：
前往 Google Cloud 控制台的 Marketplace SDK「應用程式設定」頁面：
根據前一節的判斷結果，填寫各個部分。
按一下「儲存草稿」。
(選用) 您可以在 Google Analytics 中取得應用程式使用情況的分析資料。如要這麼做，請在 Marketplace SDK 中新增 Google Analytics ID。
- 前往「數據分析」分頁。
- 輸入 Google Analytics ID。
- 按一下 [儲存]。
疑難排解
本節說明您可能會遇到的常見問題。
將應用程式發布至 Marketplace 時缺少必要權限
您無法在 Marketplace 上發布應用程式，因為嘗試在 Marketplace SDK 的「應用程式設定」頁面中設定應用程式時，會失敗並顯示下列錯誤訊息：
You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update
啟用 Marketplace SDK API，並使用 Editor 或 Owner 以外的 IAM 角色時，就會發生這個錯誤。
如要解決這項錯誤，請採用下列任一解決方法：
請專案擁有者將
roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin角色指派給缺少權限的帳戶，允許該帳戶在 Marketplace SDK 中設定及管理應用程式。請專案擁有者透過 Google Cloud 控制台的「IAM 與管理」>「角色」頁面，將缺少的權限新增至自訂角色。然後將自訂角色指派給缺少權限的帳戶。
您可以使用 Primitive
roles/editor或roles/owner發布應用程式。 不過，安全地使用 IAM 文件認為這是不良做法，因為您無法輕易限制專案中其他資源的編輯存取權。