本頁面說明如何使用 Google Workspace Marketplace SDK 設定及管理 Google Workspace Marketplace 上的應用程式。
如要開放使用您的應用程式，您必須在 Google Workspace Marketplace SDK 中設定該應用程式。Google Workspace Marketplace SDK 是一個工具包，可讓您在 Google Workspace Marketplace 上建立及控管應用程式。您可以使用 Google Workspace Marketplace SDK 管理 Marketplace 設定，例如：
- 您的應用程式是否適用於特定 Google Workspace 機構 (私人應用程式)，或是所有 Marketplace 使用者 (公開應用程式) 提供。
- 可安裝您應用程式的 Marketplace 使用者類型
- 您的應用程式與哪些 Google Workspace 應用程式整合
- 應用程式所需的 OAuth 範圍
- 開發及維護應用程式的相關資訊
無論您選擇公開或私人發布應用程式，都必須使用 Google Workspace Marketplace SDK 管理 Marketplace 中的應用程式。
啟用 Google Workspace Marketplace SDK
如果尚未啟用，請在 Google Cloud 專案中啟用 Google Workspace Marketplace SDK：
- 開啟 Google Cloud 控制台。
- 按一下頂端的「選取專案」。如果有其他 Google Cloud 專案已開啟，請按一下 Cloud 專案名稱即可切換 Cloud 專案。
- 選取應用程式的 Cloud 專案，然後按一下「Open」(開啟)。
- 在頂端的搜尋列中輸入
Google Workspace Marketplace SDK，然後按下 Enter 鍵。 開啟 Google Workspace Marketplace SDK 頁面。
如果 Google Workspace Marketplace SDK 尚未啟用，請按一下「啟用」。
在 Google Workspace Marketplace SDK 中輸入應用程式設定
- 開啟 Google Workspace Marketplace SDK。
- 前往「App Configuration」分頁標籤。
- 請在各個部分填寫應用程式的相關資訊。如要瞭解各項設定，請參閱「應用程式配置設定」一節。
- 點按「儲存」。
- (選用) 您可以在 Google Analytics (分析) 中取得應用程式使用情況的數據分析。方法是在 Google Workspace Marketplace SDK 中新增 Google Analytics (分析) ID。
- 前往「數據分析」分頁。
- 輸入您的 Google Analytics (分析) ID。
- 點按「儲存」。
應用程式設定
以下參考資料說明 Google Workspace Marketplace SDK「應用程式設定」頁面中提供的設定。
應用程式顯示設定
如果您使用 Google Workspace 帳戶 (由公司或學校機構建立的帳戶)，就會看到「App Visibility」(應用程式顯示設定) 選項。如果您使用個人帳戶 (結尾為「@gmail.com」的帳戶)，就只能公開發布。
- 公開：網域以外的使用者皆可找到及安裝應用程式。如果您選擇公開瀏覽權限，Google 會先審查並核准應用程式清單，然後再發布應用程式。
- 私人：只有網域中的使用者才能找到並安裝您的應用程式。
如果您選擇發布「不公開」，應用程式資訊就不會顯示在瀏覽或搜尋結果中。使用者只能透過直接網址存取應用程式的商店頁面。
如果您想限制應用程式的發布國家/地區，可以在建立商店資訊時在「發行」部分中設定。
安裝設定
安裝設定可決定使用者或 Workspace 管理員是否能從 Google Workspace Marketplace 的商店資訊頁面安裝應用程式。
- 個人 + 管理員安裝 (預設)：可由個別使用者或管理員安裝其網域、機構單位或使用者群組來安裝應用程式。即使啟用了個別安裝功能，使用者的網域政策可能會禁止使用者安裝應用程式。
- 僅限管理員安裝：只有網域、機構單位或使用者群組的管理員可以安裝應用程式。只有管理員和未登入 Google 帳戶的使用者，才能在 Google Workspace Marketplace 搜尋結果中看到您的應用程式。如果應用程式需要安裝網域，請選擇這個選項。
應用程式整合
選擇可搭配應用程式或外掛程式使用的 Google Workspace 服務，例如 Google Workspace 外掛程式或 Google Chat 應用程式。您必須選擇至少一個選項。在某些情況下，您可以在應用程式資訊中納入多項應用程式整合。請參閱「一併列出應用程式整合」。
視所選應用程式整合而定，您可能需要提供更多資訊，並在 Google Cloud 專案中啟用相關的 API。下表說明各項目所需的額外設定：
Google Workspace 外掛程式 (Apps Script)
如要發布 Google Workspace 外掛程式，您必須提供外掛程式的部署作業 ID。如要查詢部署作業 ID，請按照下列步驟操作：
- 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
- 按一下「Deploy」(部署) > 「Manage deployment」(管理部署作業)。
- 在部署作業 ID 下方，按一下「Copy」。
Google Workspace 外掛程式 (替代執行階段)
如果您是使用 Google Apps Script 以外的程式語言建構 Google Workspace 外掛程式，請按照下列步驟從 Google Cloud 部署資源取得部署項目 ID。
- 在「應用程式設定」頁面的「Google Workspace 外掛程式」下方，按一下「使用雲端部署作業資源部署 > 選取部署作業」。
- 選取您要發布的部署作業。
- 按一下「選取」。
編輯器外掛程式 (文件、試算表、簡報、表單)
如要發布編輯器外掛程式，您必須提供要發布的專案指令碼 ID 和版本。
如要找出專案指令碼 ID，請按照下列步驟操作：
- 在 Apps Script 編輯器中開啟外掛程式。
- 按一下左側的「專案設定」圖示 。
- 複製「ID」底下的指令碼 ID。
如要找出版本，請按照下列步驟操作：
- 在 Apps Script 編輯器中開啟外掛程式。
- 依序按一下右上方的「部署」> 「管理部署作業」。
- 版本號碼會顯示在「設定」下方。
Google Chat 應用程式
您必須設定 Google Chat API，才能發布 Google Chat 應用程式。 請參閱「 發布應用程式」一文。
雲端硬碟應用程式
如要發布雲端硬碟應用程式，您必須啟用及設定 Drive API。
網頁應用程式
如要發布網頁應用程式，您必須提供通用導覽網址，也就是從 Google 應用程式選單 指向網頁應用程式的網址。您的網頁應用程式必須處於實際工作環境且功能完整。
填寫商店資訊頁面時，您必須提供 96x96 和 48x48 像素大小的其他圖示。
如果您在 Apps Script 中建構了網頁應用程式，請按照下列步驟取得通用導覽網址：
- 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
- 依序點選「Deploy」(部署) > 「New Deployment」(新增部署作業)。
- 在「選取類型」下方，按一下「網頁應用程式」。
- 填入選項，然後按一下「Deploy」(部署)。
- 按一下「複製」。
OAuth 範圍
請提供應用程式所需的 OAuth 範圍完整清單。您在這裡輸入的 OAuth 範圍必須符合 OAuth 同意畫面中顯示的內容，以及 Apps Script 資訊清單 (如適用)。
如果您納入多個應用程式整合，請務必將各個應用程式整合範圍新增至「Google Workspace Marketplace SDK App Configuration」頁面和 OAuth 同意畫面。
請一律使用最小的範圍 (舉例來說，如果您只需要唯讀範圍，請不要納入完整的雲端硬碟範圍)。
如要進一步瞭解 Apps Script 專案，請參閱「範圍」一文。
開發人員資訊
| 欄位 | |
|---|---|
| 交易商狀態 |
根據消費者保護法，歐洲經濟區 (EEA) 境內的消費者必須告知 Google Workspace Marketplace 中的商家是否為交易商或非交易商：
如未指定，應用程式的「商店資訊」頁面會顯示「未指定經銷商狀態」。 |
| 開發人員郵寄地址 |
交易商為必填項目。不會為非交易商收集。 商家的所在地點。請輸入可以聯繫上您的有效郵寄地址。 |
| 開發人員名稱 | 顯示為應用程式作者的名稱。如果您是交易商，請提供商號或法定名稱。 |
| 開發人員網站網址 | 您 (或貴機構) 描述為開發人員的網站。 |
| 開發人員電子郵件地址 |
做為聯絡窗口的電子郵件地址。不在應用程式資訊中。請務必提供最新的電子郵件地址，這是使用的地址：
|
| 應用程式網站網址 | (選填) 應用程式的詳細說明。 |