在 Google Workspace Marketplace SDK 中設定應用程式

本頁面說明如何使用 Google Workspace Marketplace SDK 設定及管理 Google Workspace Marketplace 上的應用程式。

如要讓應用程式可供使用，您必須在 Marketplace 中進行設定。Marketplace SDK 是一組工具包，可讓您在 Google Workspace Marketplace 上建立及控管應用程式。您可以使用 Marketplace SDK 管理 Marketplace 設定，例如：

  • 應用程式是否可供特定 Google Workspace 機構使用 (私人應用程式)，或是可供所有 Marketplace 使用者使用 (公開應用程式)
  • 可安裝應用程式的 Marketplace 使用者類型
  • 應用程式整合的 Google Workspace 應用程式
  • 應用程式所需的 OAuth 範圍
  • 應用程式建構和維護人員的相關資訊

無論您是發布私人或公開應用程式，都必須使用 Marketplace SDK 來管理 Marketplace 上的應用程式。

啟用 Marketplace SDK

如果您尚未在 Google Cloud 專案中啟用 Google Workspace Marketplace SDK，請先啟用。

在 Google Cloud 控制台中開啟 Cloud 專案

如果尚未開啟，請開啟要用於這個範例的 Cloud 專案：

  1. 在 Google Cloud 控制台中，前往「Select a project」頁面。

    選取 Cloud 專案

  2. 選取要使用的 Google Cloud 專案。或者，您也可以按一下「建立專案」，然後按照畫面上的指示操作。如果您建立 Google Cloud 專案，可能需要為專案啟用計費功能。

啟用 Google Workspace Marketplace SDK

使用 Google API 前，您必須先在 Google Cloud 專案中啟用這些 API。您可以在單一 Google Cloud 專案中啟用一或多個 API。

  • 在 Google Cloud 控制台中，啟用 Google Workspace Marketplace SDK。

    啟用 SDK

決定應用程式的配置設定

以下參考資料說明 Marketplace SDK 中「App Configuration」(應用程式設定) 頁面提供的設定。

選擇哪些人可以查看及安裝您的應用程式

設定應用程式時，您可以使用下列設定指定可存取應用程式的使用者：

  • 應用程式顯示設定：如果您要在 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 管理員是否可透過 Google Workspace Marketplace 中的商店資訊頁面安裝您的應用程式。

  • 個人 + 管理員安裝 (預設)：個別使用者或管理員可為其網域、機構單位或使用者群組安裝應用程式。即使啟用個別安裝功能，使用者的網域政策仍可能會禁止他們安裝應用程式。
  • 僅限管理員安裝：只有管理員可以為自己的網域、機構單位或使用者群組安裝應用程式。您的應用程式只會顯示在 Google Workspace Marketplace 搜尋結果中，且只會顯示給管理員和未登入 Google 帳戶的使用者。如果應用程式需要安裝網域，請選擇這個選項。

常見的安裝和瀏覽權限設定

下表列出一些常見的應用程式設定選項，可用於設定安裝和顯示方式：

應用程式的目標使用者 「應用程式顯示設定」 「應用程式安裝」設定 哪些人可以安裝我的應用程式？ 誰可以使用我的應用程式？
針對為 Google Workspace 機構建構的應用程式  
貴機構的特定使用者 「私人」和「不公開」 個人 + 管理員安裝 如果允許，貴機構中知道應用程式資訊清單網址的所有使用者。 在許可的情況下，凡是貴機構擁有應用程式資訊網址的機構使用者。
貴機構 私人 個人 + 管理員安裝 如果允許，貴機構的任何人。 如有開放，貴機構中的任何使用者。
貴機構 私人 僅限管理員 管理員 由管理員安裝應用程式的使用者。
適用於特定 Google Workspace 機構外使用者的應用程式  
Google Workspace 機構中的使用者 公開 僅限管理員 管理員 由管理員安裝應用程式的使用者。
所有 Google Workspace 使用者 公開 個人 + 管理員安裝
  • 任何將 Google Workspace 應用程式用於個人用途的使用者。
  • 在 Google Workspace 機構中，使用者可視情況使用這項功能。
  • 任何將 Google Workspace 應用程式用於個人用途的使用者。
  • 在 Google Workspace 機構中，使用者可視情況使用這項功能。

瞭解應用程式如何與 Google Workspace 應用程式整合

選擇應用程式或外掛程式將與之搭配運作的 Google Workspace 服務，例如 Google Workspace 外掛程式或 Google Chat 應用程式。您必須至少選擇一個選項。在某些情況下，您可以在應用程式資訊中加入多個應用程式整合項目。請參閱「一併列出應用程式整合功能」。

視您選擇的應用程式整合服務而定，您可能需要在 Google Cloud 專案中提供更多資訊並啟用相關 API。下表說明各項功能所需的額外設定：

Google Workspace 外掛程式 (Apps Script)

如要發布 Google Workspace 外掛程式，您必須提供外掛程式的部署 ID。如要找出部署 ID，請按照下列步驟操作：

  1. 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
  2. 依序點選「部署」> 「管理部署作業」。
  3. 按一下部署作業 ID 下方的「複製」。

Google Workspace 外掛程式 (HTTP 部署作業)

如果您使用 HTTP 端點建構 Google Workspace 外掛程式，請按照下列步驟從 Google Cloud 部署資源取得部署 ID。

  1. 在「應用程式設定」頁面的「Google Workspace 外掛程式」下方，按一下「HTTP 或其他部署」>「選取部署」 。
  2. 選取要發布的部署作業。
  3. 按一下「選取」。

編輯器外掛程式 (文件、試算表、簡報、表單)

如要發布編輯器外掛程式，您必須提供要發布的專案指令碼 ID 和版本。

如要找出專案指令碼 ID，請按照下列步驟操作：

  1. 在 Apps Script 編輯器中開啟外掛程式。
  2. 按一下左側的「專案設定」圖示 。
  3. 在「ID」下方複製指令碼 ID。

如要查看版本，請按照下列步驟操作：

  1. 在 Apps Script 編輯器中開啟外掛程式。
  2. 依序按一下右上方的「部署」> 「管理部署作業」。
  3. 版本號碼會顯示在「設定」下方。

Google Chat 應用程式

如要發布 Google Chat 應用程式，您必須設定 Google Chat API。請參閱「發布 Google Chat 應用程式」一文。

雲端硬碟應用程式

如要發布 Drive 應用程式，您必須啟用並設定 Google Drive API。

網頁應用程式

如要發布網頁應用程式，您必須提供通用導覽網址，也就是從 Google 應用程式選單 指向網頁應用程式的網址。網頁應用程式必須是正式版，且功能完整。

填寫商店資訊頁面時，您必須提供大小為 96x96 和 48x48 像素的其他圖示。

如果您在 Apps Script 中建構了網路應用程式，請按照下列步驟取得通用導覽網址：

  1. 在 Apps Script 編輯器中開啟 Google Workspace 外掛程式。
  2. 依序按一下「部署」> 「新部署作業」。
  3. 按一下「選取類型」下方的「網頁應用程式」。
  4. 填寫選項，然後按一下「部署」。
  5. 點按「複製」。

指定應用程式所需的存取層級

在「OAuth 範圍」下方，提供應用程式所需的 OAuth 2.0 範圍完整清單。您在這裡輸入的 OAuth 範圍應與 OAuth 同意畫面中顯示的範圍相符，並且在適用情況下，也應與 Apps Script 資訊清單相符。

如果您包含多個應用程式整合，請務必將各個整合範圍的範圍新增至 Marketplace SDK 的「應用程式設定」頁面和 OAuth 同意畫面。

請一律使用最狹隘的範圍 (例如，如果您只需要唯讀範圍，請勿納入完整的 Drive 範圍)。

如要進一步瞭解 Apps Script 專案，請參閱「授權範圍」一文。

提供應用程式開發人員的相關資訊

在「開發人員資訊」下方填入聯絡資訊和其他詳細資料。這些欄位會顯示在應用程式的商店資訊頁面。

欄位
交易商狀態

根據消費者保護法，我們必須向歐洲經濟區 (EEA) 境內的消費者告知，Google Workspace Marketplace 上的商家是否為交易商或非交易商：

  • 交易商：交易商是指基於交易、業務、技術或專業相關目的，或以交易商名義或代表交易商行事的人士。
  • 非交易商：非交易商 (消費者) 是指基於非專業目的而採取行動的人。

如果未指定，應用程式的商店資訊頁面會顯示「未指定交易者狀態」。
開發人員名稱 要顯示為應用程式作者的名稱。如果您是交易者，請提供商業名稱或法定全名。
開發人員郵寄地址

交易人必填。不向非交易商收集。

商家所在地點。請輸入可聯繫到您的有效郵寄地址。
開發人員網站網址 說明您 (或貴機構) 為開發人員的網站。
開發人員電子郵件

做為聯絡窗口的電子郵件地址。但未列入應用程式資訊。請確認這個電子郵件地址處於使用中的最新狀態：

  • 如果 Google 需要與開發人員聯絡，例如在應用程式審查程序期間。
  • 如何在商店資訊頁面中未提供「回報問題」網址時，透過編輯器外掛程式提供意見。
應用程式網站網址 選用設定。進一步說明應用程式的網站。

在 Marketplace SDK 中儲存應用程式設定

請參閱上一節的資訊，在 Marketplace SDK 中儲存應用程式設定：

  1. 前往 Google Cloud 控制台的 Marketplace SDK「Configuration」頁面：

    前往 Marketplace SDK 設定頁面

  2. 根據您在上一節中所做的決定，填寫各個部分。

  3. 按一下 [儲存]。

  4. (選用) 您可以在 Google Analytics 中取得應用程式使用情形的數據分析。方法很簡單，只要在 Marketplace SDK 中加入 Google Analytics ID，

    1. 前往「數據分析」分頁。
    2. 輸入 Google Analytics ID。
    3. 按一下 [儲存]。