本頁面說明如何使用 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
如果您尚未啟用 Marketplace SDK，請在 Google Cloud 雲端專案中啟用該 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 應用程式建構為外掛程式，則必須在 Chat API 中設定外掛程式設定。如需相關步驟，請參閱 Google Workspace 外掛程式說明文件中的「設定 Chat 應用程式」。
- 如果您是使用互動事件建構 Chat 應用程式，則必須在 Chat API 中設定互動事件設定。如需相關步驟，請參閱 Chat API 說明文件中的「接收及回覆互動事件」。
- 如果您使用 AppSheet 的自動設定功能建構 Chat 應用程式，請按照 AppSheet 說明文件中的步驟發布 Chat 應用程式，請參閱「使用自動設定功能分享 Chat 應用程式」。
Google 雲端硬碟應用程式
如要發布雲端硬碟應用程式，您必須啟用並設定 Google Drive API。
網頁應用程式
如要發布網頁應用程式，請提供通用導覽網址，也就是從 Google 應用程式選單 指向網頁應用程式的網址。網頁應用程式必須處於正式版狀態，且功能完備。
填寫商店資訊頁面時，您必須提供 96x96 和 48x48 像素大小的額外圖示。
如果您是在 Apps Script 中建構網頁應用程式，請按照下列步驟取得通用導覽網址：
- 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
- 依序按一下「Deploy」(部署) > 「New deployment」(新部署作業)。
- 在「選取類型」下方，按一下「網頁應用程式」。
- 填寫選項，然後按一下「部署」。
- 點選「複製」。
指定應用程式所需的存取層級
在「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 & Admin」>「Roles」(角色) 頁面，將缺少的權限新增至自訂角色。然後將自訂角色指派給缺少權限的帳戶。
您可以使用原始
roles/editor或roles/owner發布應用程式。 不過，安全地使用 IAM 文件認為這種做法不當，因為無法輕易限制專案中其他資源的編輯存取權。