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

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

如要讓應用程式可供使用,您必須在 Marketplace SDK 中設定應用程式。您可以使用 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 應用程式」一文。

雲端硬碟應用程式

如要發布雲端硬碟應用程式,您必須啟用並設定 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. 按一下 [儲存]