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

本頁面說明如何使用 Google Workspace Marketplace SDK 設定及管理 。

如要讓應用程式可供使用,您必須在 Google Workspace Marketplace SDK 中進行設定。 Google Workspace Marketplace SDK 工具包可讓您建立及控管 。使用 Google Workspace Marketplace SDK 管理 市集設定,例如:

  • 您的應用程式是否適用於特定 Google Workspace 機構 (為私人應用程式) 或所有 Marketplace 使用者 ( 公開應用程式)
  • 可以安裝您 應用程式
  • 您的應用程式與哪些 Google Workspace 應用程式整合
  • 應用程式所需的 OAuth 範圍
  • 應用程式建構與維護人員的相關資訊

無論要發布 公開或私人應用程式,則必須使用 Google Workspace Marketplace SDK 管理 安裝自己的應用程式

啟用 Google Workspace Marketplace SDK

如果您尚未在 Google Cloud 專案中執行這項操作 啟用 Google Workspace Marketplace SDK

  1. 開啟 Google Cloud 控制台
  2. 按一下頂端的「選取專案」。如果同一項 Google Cloud 專案 在開啟的狀態下,按一下 Cloud 專案名稱即可 以及 Google Cloud 專案
  3. 選取應用程式的 Cloud 專案,然後按一下「Open」
  4. 在頂端的搜尋列中輸入 Google Workspace Marketplace SDK,然後按下 Enter 鍵。
  5. 開啟 Google Workspace Marketplace SDK 頁面。

  6. 如果 Google Workspace Marketplace SDK 尚未啟用,請按一下「啟用」

決定應用程式的配置設定

以下參考資料說明應用程式提供的設定 Google Workspace Marketplace SDK 的設定頁面。

選擇誰能查看及安裝應用程式

設定應用程式時,您必須指定有權存取應用程式的使用者 請使用下列設定:

  • 應用程式顯示設定:如果您是在 Google Workspace 機構 (無論是否不公開應用程式資訊) 貴機構全體使用者都能查看 Google Workspace
  • 安裝設定:指出應用程式是否只能 ,由 Google Workspace 管理員安裝。

無論您在應用程式資訊中指定的設定為何,都會 Google Workspace 機構可能無法在 或根據管理員設置的設定使用您的應用程式。管理員 可能受到以下因素影響:

  • 控管使用者能否在 並代客戶安裝應用程式 使用者。
  • 使用許可清單為機構管理及收錄應用程式。如果 您正在為使用許可清單的機構開發應用程式,請務必檢查 管理員負責將應用程式加入許可清單。
  • 關閉特定 Google Workspace 應用程式,例如移除應用程式 存取 Google Chat 和/或 Google Chat 應用程式。在這些情況下 使用者將無法透過 市集。

瞭解管理員如何控管 市集,請參閱 Marketplace 管理員說明文件

應用程式瀏覽權限設定

如果您使用 Google Workspace,就會看到「應用程式顯示設定」選項 帳戶 (由公司或學校機構建立的帳戶)。如果您是 如果使用個人帳戶 (結尾是「@gmail.com」的帳戶),則您只能 公開發布。

  • 公開:外部使用者可以找到並安裝這個應用程式 網域。如果您選擇公開顯示,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 部署作業資源。

  1. 在「應用程式設定」頁面的「Google Workspace 外掛程式」下方。點擊 使用雲端部署資源進行部署 > 選取「部署」
  2. 選取要發布的部署作業。
  3. 按一下「選取」

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

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

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

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

如要查看版本,請按照下列步驟操作:

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

Google Chat 應用程式

如要發布 Google Chat 應用程式,請設定 Google Chat API。 詳情請見 發布中 應用程式

雲端硬碟應用程式

如要發布雲端硬碟應用程式,您必須啟用及設定 Drive API

網頁應用程式

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

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

如果您是透過 Apps Script 建立網頁應用程式 導覽網址,請按照下列步驟操作:

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

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

在「OAuth 範圍」下方,提供完整的應用程式 OAuth 範圍清單 而負責任的 AI 技術做法 有助於達成這項目標您在這裡輸入的 OAuth 範圍應符合 OAuth 同意畫面和 Apps Script 資訊清單 (如適用)。

如果有多個應用程式整合,請務必新增 分別連往 Google Workspace Marketplace SDK 的「應用程式設定」頁面,以及您的 OAuth 同意聲明 。

請盡可能使用最窄的範圍 (例如不要加入完整的 雲端硬碟範圍 (如果只需要唯讀範圍)。

如果是 Apps Script 專案,請參閱 範圍 ,掌握更多詳細資訊。

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

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

欄位
交易商狀態

根據消費者保護法,歐洲的消費者 請務必告知歐洲經濟區 (EEA) 上的商家是否 Google Workspace Marketplace 是「交易商」非交易商

  • 交易商:交易商是指基於相關目的而行事的人 達成貿易、業務、技術或專業目的;或名稱 。
  • 非交易商:非交易商 (消費者) 是指履行 非專業用途

如未指定,則「未指定交易商狀態」會在應用程式的 商店資訊 頁面。

開發人員郵寄地址

交易商為必填項目。不向非交易商收集。

商家的所在位置。請輸入有效的郵寄地址 可以聯絡對方。

開發人員名稱 要顯示為應用程式作者的名稱。如果您是交易商 請提供商業名稱或法定全名。
開發人員網站網址 描述您 (或貴機構) 的網站 開發人員。
開發人員電子郵件地址

做為聯絡窗口的電子郵件地址。是 未列於應用程式資訊中。確保這個電子郵件地址不會超過 日期,用於:

  • 如果 Google 需要與開發人員聯絡 (例如在 應用程式審查程序。
  • 在不是「回報問題」網址的情況下,如何透過編輯器外掛程式提供意見 。
應用程式網站網址 選用設定。進一步說明您的應用程式的網站。

將應用程式配置設定儲存在 Google Workspace Marketplace SDK 中

根據上一節的資訊, 將應用程式設定儲存在 Google Workspace Marketplace SDK 中:

  1. 開啟 Google Workspace Marketplace SDK
  2. 前往「App Configuration」分頁。
  3. 請根據您在 上一節
  4. 按一下 [儲存]
  5. (選用) 您可以取得應用程式使用情況數據分析Google Analytics 中進行設定。 請加入 Google Analytics ID
    1. 前往「數據分析」分頁。
    2. 輸入 Google Analytics ID。
    3. 按一下 [儲存]