在 Google Workspace Marketplace SDK 中配置应用

本页介绍了如何使用 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 用户( public 应用)
  • 可以安装您的 应用
  • 您的应用集成了哪些 Google Workspace 应用
  • 您的应用所需的 OAuth 范围
  • 与构建和维护应用的人员相关的信息

无论您是要发布 公开或私密地向您的应用公开,您必须使用 Google Workspace Marketplace SDK 来管理您的 。

启用 Google Workspace Marketplace SDK

在您的 Google Cloud 项目中, 启用 Google Workspace Marketplace SDK

  1. 打开 Google Cloud Console
  2. 点击顶部的选择项目。如果使用的是其他 Google Cloud 项目 已经打开,请点击 Cloud 项目名称进行切换 Cloud 项目。
  3. 选择应用的 Cloud 项目,然后点击打开
  4. 在顶部的搜索栏中输入 Google Workspace Marketplace SDK,然后按 Enter 键。
  5. 打开 Google Workspace Marketplace SDK 页面。

  6. 如果您尚未启用 Google Workspace Marketplace SDK,请点击启用

确定应用的配置设置

以下参考介绍了 App Engine 上的 配置页面。

选择哪些人可以查看和安装您的应用

配置应用时,您需要指定可以访问应用的用户 使用以下设置:

  • 应用显示设置:如果您要在 Google Play 上 使用 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 账号的用户。如果您的应用 需要安装域。

常用的安装和公开范围设置

下表总结了 Cloud SQL 中一些常见的应用配置选项 安装和可见性:

目标应用用户 应用显示设置 应用安装设置 谁可以安装我的应用? 哪些人可以使用我的应用?
适用于专为 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 脚本)

要发布 Google Workspace 插件,您必须提供插件的 部署 ID如需查找部署 ID,请按以下步骤操作:

  1. 在 Apps 脚本中打开 Google Workspace 插件 编辑器。
  2. 点击部署> 管理部署
  3. 在部署 ID 下,点击复制

Google Workspace 插件(替代运行时)

如果您构建 Google Workspace 插件时所使用的编程语言不是 Google Apps 脚本,请按照以下步骤从 Google Cloud 部署资源。

  1. 在“应用配置”页面的“Google Workspace 插件”下,点击 使用云部署资源进行部署 > 选择“部署”。
  2. 选择要发布的部署。
  3. 点击选择

编辑器插件(文档、表格、 Google 幻灯片、Google 表单)

要发布编辑器插件,您必须提供 要发布的项目脚本 ID版本

如需查找项目脚本 ID,请按以下步骤操作:

  1. 在 Apps 脚本编辑器中打开该插件。
  2. 点击左侧的项目设置
  3. 在“ID”下,复制脚本 ID。

要查找版本,请按以下步骤操作:

  1. 在 Apps 脚本编辑器中打开该插件。
  2. 点击右上角的部署> 管理部署
  3. 版本号就在“配置”下。

Google Chat 应用

要发布 Google Chat 应用,您必须配置 Google Chat API。 请参阅 发布 应用

云端硬盘应用

要发布云端硬盘应用,您必须启用并配置 Drive API

Web 应用

要发布 Web 应用,您必须提供其通用导航网址,即 从 Google 应用菜单 指向 Web 应用。您的 Web 应用必须为正式版且功能齐全。

在填写“商品详情”页面时,您必须提供其他图标 尺寸分别为 96x96 和 48x48 像素。

如果您使用 Apps 脚本构建了 Web 应用, 导航网址,请按以下步骤操作:

  1. 在 Apps 脚本中打开 Google Workspace 插件 编辑器。
  2. 点击部署> 新建部署
  3. 在“选择类型”下点击 Web 应用
  4. 填写选项,然后点击部署
  5. 点击复制

指定您的应用所需的访问权限级别

OAuth 范围下,提供应用的 OAuth 范围的完整列表 所需的资源。您在此处输入的 OAuth 范围应与您在 OAuth 同意屏幕和 Apps 脚本清单(如适用)。

如果您添加多个应用集成,请务必从以下位置添加范围: 将每一项都添加到 Google Workspace Marketplace SDK 的“应用配置”页面,并征得您的 OAuth 同意 屏幕。

始终使用尽可能小的范围(例如,不添加完整的 云端硬盘范围(如果您只需要只读范围)。

对于 Apps 脚本项目,请参阅 了解详情。

提供应用开发者的相关信息

开发者信息下方,填写联系信息和其他详细信息。 这些字段会显示在您应用的 商品详情页面。

字段
交易者状态

根据消费者保护法,欧洲境内的消费者 必须告知欧洲经济区 (EEA) 内的商家, Google Workspace Marketplace 是一个交易者非交易者

  • 交易者 - 交易者是指以特定目的为目的而进行交易的人 专业、商业、工艺或专业领域;或姓名中 代表交易者。
  • 非交易者 - 非交易者(消费者)是指 用于非专业目的。

如果未指定,则“未指定交易者状态”出现在您应用的 商品详情 页面。

开发者邮寄地址

交易者必须填写。不会为非交易者收集。

您的营业地点。请输入有效的邮寄地址 联系。

开发者名称 显示为应用作者的名称。如果您是交易者 提供您的商号或法定名称。
开发者网站网址 将您(或您的组织)描述为 开发者。
开发者电子邮件地址

要用作联系人的电子邮件地址。时间是 。确保此电子邮件地址 date - 使用:

  • 如果 Google 需要与开发者联系(例如,在 应用审核流程。
  • 在“报告问题”网址不显示时,通过编辑器插件发送反馈 “应用详情”页面上提供的信息。
应用网站网址 可选。进一步说明您的应用的网站。

将您的应用配置设置保存在 Google Workspace Marketplace SDK 中

利用上一部分中的信息, 将您的应用配置保存在 Google Workspace Marketplace SDK 中:

  1. 打开 Google Workspace Marketplace SDK
  2. 转到应用配置标签页。
  3. 请根据您在 上一节
  4. 点击保存
  5. (可选)您可以获取有关应用使用情况的分析数据 (位于 Google Analytics 中)。 为此,请添加 Google Analytics ID
    1. 进入数据分析标签页。
    2. 输入您的 Google Analytics ID。
    3. 点击保存