Google Workspace Marketplace 的应用审核流程和要求

• 说明中提供了用于与应用通信的按钮。
• 应用名称以 A-Z（大写）或 0-9 开头。不能以符号开头。

• Chat 应用具有互动功能，可添加到私信或聊天室中。

• 每当用户发起私信或将应用添加到聊天室时，该应用都会自动发送欢迎消息。欢迎消息不同于“帮助”命令。查看文档。
• 应用支持“帮助”命令，可帮助用户上手使用。 查看文档。
• 在聊天室或私信中对应用说话时，应用始终会做出回应。
• 消息的拼写、大小写、标点符号和语法正确无误。消息不包含恶意、冒犯性或辱骂性内容。
• 消息根据 Google 要求，对文本或卡片使用清晰、简洁且一致的格式。
• 如果响应时间超过 2 秒，应用会发送一条消息来说明延迟情况。
• 发送通知的应用应允许用户关闭通知。
• 用户可以使用 @提及功能将应用添加到聊天室。
• 用户可以使用查看成员菜单从聊天室中移除应用。
• 应用向用户指明与其互动所需的一切信息。
• 应用使用的卡片格式符合 Google 要求。查看文档。
• 您可以通过 Chat 菜单中的查找应用选项使用该应用。
• 应用与之交互的外部网址不属于预演环境或开发环境。
• 在聊天室中向应用发送的每条消息中都必须使用“@”提及该应用。 只有这样，应用才能知道它必须做出响应。
• 如果 Chat 应用预览来自第三方网域的链接：
  • 链接预览可提供与用户消息相关的补充信息。例如，预览指向销售交易的链接会添加账号、金额和阶段等信息。
  • 开发者与预览网域有联属关系。

  如需了解如何预览链接，请查看文档。

• （推荐）为了让 Workspace 管理员能够代表其组织中的用户安装您的应用，您的应用必须能够接收和发送私信。

• 应用具有清晰可辨的头像。

• 该应用不会使用 Chrome 浏览器扩展程序直接操控云端硬盘 HTML 来提供功能。
• 如果您的应用使用敏感或受限范围，则必须接受 OAuth 验证。请参阅提交应用以进行验证。
• 如果您的应用使用受限范围，则还必须接受安全评估。请参阅安全评估。

• 如果应用在云端硬盘中存储文件，则应允许用户选择文件夹，或创建并重复使用特定于应用的文件夹。配置数据可以存储在“应用数据”文件夹中。应用不会将文件转储到用户的“我的云端硬盘”文件夹中。
• 应用仅在与应用的已记录功能相关联的云端硬盘中存储文件。

• 该插件包含预期和必需的操作，并提供完成其工作流所需的所有工具。例如：
  • 如果该插件将样式应用于整个文档，则会提供仅将样式应用于所选文字的选项。
  • 如果该插件将电子表格数据上传到 Web 服务 Feed，则会提供指向该 Feed 的链接，以便用户轻松浏览。
  • 如果该插件要求用户拥有账号，则应提供链接或信息，以便用户在没有账号的情况下轻松创建账号。
• 该插件在插件标签页下有菜单项。
• 即使该插件只是自定义函数，也应包含适当的文档。
• 该插件正确使用 onInstall() 和 onOpen() 来填充其菜单。在首次安装插件和打开其他文件时，系统会填充菜单项。请参阅 编辑器插件授权。
• 授权模式设置正确无误。请参阅 授权模式。
• 该插件必须在 Apps 脚本的 V8 运行时中实现。如需了解详情，请参阅 V8 运行时概览。

• 该插件提供了所有必要的信息，以便用户对产品及其使用方法有一个基本了解。
• 插件代码不会过度使用库，因为库可能会导致插件性能下降。
• 尽可能避免错误并妥善管理错误，如果无法避免错误，则：
  • 错误消息会显示在对话框窗口中，而不是在 JavaScript 提醒或默认红色栏中。它们使用简单的语言说明问题并说明用户必须执行哪些操作才能解决问题。
  • 如果用户执行了错误的操作，系统会尽可能显示一个按钮，以便用户解决问题。
  • 如需了解详情，请参阅 插件样式指南。
• 指向外部网页的链接会在新窗口中打开，且正确无误。
• 该插件设计直观、用途广泛。这意味着：
  • 用户始终清楚该做什么以及如何做。
  • 该插件易于使用且简单易懂。避免使用技术术语和行话。
  • 工作流程清晰且尽可能简化。
  • 尽可能保障用户及其内容的安全。
• 该插件遵循 适用于编辑器插件的界面样式指南，并使用 适用于编辑器插件的 CSS 软件包。
• 该插件每个显示屏仅使用一个蓝色主操作。
• 该插件一次只能显示一个对话框。不会重叠或同时打开多个对话框。
• 该插件界面能整齐地填充分配的空间：
  • 文本和标签不会被“...”截断
  • 用户无需进行大量垂直滚动。
  • 内容宽度不超过 300p，因此没有水平滚动条。
• 该插件会要求用户对所有敏感操作进行确认或显示警告。例如，如果该插件即将覆盖电子表格中的所有内容，系统会在操作执行之前向用户发出警告，并让用户确认操作。

  您可以通过更改设计来避免此要求。 例如，导入数据的 Google 表格插件可能会导致覆盖现有内容。您可以通过创建一个作为默认操作的数据工作表来消除风险。

• 在操作加载期间，用户无法多次触发操作。例如，在操作加载期间，按钮会关闭或隐藏。

日历插件

• 如果插件使用 calendar.name 或 common.name，清单中的名称与应用详情中提供的名称相同。
• 如果该插件使用 calendar.conferenceSolution，则会议解决方案名称不包含“Google 日历”。
• （推荐）如果该插件使用 calendar.conferenceSolution，会议解决方案名称不得超过 30 个字符。

• 该插件使用正确的界面元素（例如 Meet 插件中的 widget 或 iframe 界面）来实现所需功能。例如，使用开关来选择布尔值。

日历插件

• 支持辅助日历和委托，如果不支持，则会妥善管理。例如，如果用户在创建活动时选择了他们有修改权限的其他日历，会议创建不会失败。
• 周期性活动正常运行。
• 如果该插件使用 calendar.conferenceSolution，则必须提供至少一个会议解决方案。
• 如果该插件提供会议解决方案，则会使用适当的会议数据字段。例如，视频会议链接、电话号码、SIP 链接、访问码和其他受支持的属性使用结构化数据字段，而非在备注字段中提供。
• 如果该插件提供视频会议解决方案，则只能修改会议详细信息，而不能修改其他活动字段。
• 如果该插件提供会议解决方案，则创建会议所需的时间不超过 5 秒。

Gmail 插件

如果该插件使用 UrlFetchApp 或 OpenLinkUrl：

• 网址有效。
• 网址使用的是 HTTPS（而非 HTTP）。
• 指定了完整网域。
• 路径不为空。例如，可以使用 https://altostrat/，但不能使用 https://altostrat。
• UrlFetchApp 中不能使用通配符。

Meet 插件

• 即使停用了第三方 Cookie，插件登录和用户历程也必须正常运行。
• 该插件必须提供与会议的操作或参与相关的功能。
• 该插件不得执行任何会导致用户退出会议的操作，例如刷新浏览器。
• 如果使用多人游戏体验，该插件必须允许所有参与者协同创作内容，即使未事先设置权限也是如此。在协作式插件会话期间，必须能够调整权限。
• 该插件必须处理启动 activity 流程的取消，并允许用户从应用重新启动 activity。
• 该插件必须提供用于登录和设置活动体验的侧边栏。
• 该插件不得提供用于邀请聊天机器人的功能，也不得依赖于会议中是否存在聊天机器人

• 该插件有一个首页。如果您的 Google Workspace 插件是转换后的 Gmail 插件，则系统会应用默认首页。
• 界面元素（例如 Meet 插件中的插件卡片或 iframe 界面）正常运行。例如，没有重复项；返回、刷新和更新按钮会相应地运行。
• 用户授权该插件后，该插件会显示信息（例如自定义的首页卡片或 Meet 插件中的网页），并显示登录按钮（如有）、徽标和插件的简短说明，以欢迎用户。
  • 如果触发登录按钮，系统会显示第三方供应商的自定义登录页面，其中明确指明有第三方服务在 Google Workspace 之外运行。
• 该插件界面能整齐地填充分配的空间：
  • 文本和标签不会被“...”截断
  • 用户无需进行大量垂直滚动。
  • 内容宽度不超过 300p，因此没有横向滚动条。
• 该插件代码不会过度使用库，因为库可能会导致插件性能下降。

日历插件

• 如果该插件提供会议解决方案，则创建的会议有效且会在第三方会议网站上正确显示。

Google 文档插件

如果该插件预览来自第三方网域的链接（智能条状标签），则：

• 链接预览可向用户提供相关的补充信息。 例如，预览指向销售交易的链接会添加账号、金额和阶段等信息。
• 开发者与预览的网域（触发智能条状标签创建的指定网址格式）相关联。

如需了解详情，请参阅包含智能条状标签的预览链接。

云端硬盘插件

• 如果应用在云端硬盘中存储文件，则应允许用户选择文件夹，或创建并重复使用特定于应用的文件夹。配置数据可以存储在“应用数据”文件夹中。应用不会将文件转储到用户的“我的云端硬盘”文件夹中。
• 该插件仅在云端硬盘中存储与该插件已记录的功能相关的文件。

Gmail 插件

• 未经正当理由，插件未提及或链接到 Chrome 浏览器扩展程序。
• “更多操作”菜单 more_vert包含可正常运行的通用操作。例如“退出”“关于”“支持”等

Meet 插件

• 如果插件需要许可或订阅：当用户没有许可时，必须向用户显示一则简单易懂的消息。
• 如果用户因许可问题而无法使用插件，错误消息必须明确说明无法使用插件的原因，并建议用户采取措施来解决此问题。
• 插件的 Google Workspace Marketplace 商品详情必须详细说明使用该插件可能需要满足的许可和订阅要求。如果插件有付费层级，Marketplace 商品详情必须提供指向网页的链接，该网页应提供有关价格或如何联系销售人员的更多信息。
• 如果用户尚未登录，该插件必须显示显示 Google One Tap 中所述的一键登录提示，以及身份验证中所述的“使用 Google 账号登录”回退选项。除了“使用 Google 账号登录”机制之外，您还可以提供其他登录选项。
• 该插件必须采用响应式设计，以便内容能够适应不同的尺寸。
• 即使停用了第三方 Cookie，插件用户体验历程也必须正常运行。
• 该插件不得在 iframe 中进行水平滚动。
• 如果插件想要使用主舞台，则必须针对多人体验进行设计，并允许多个参与者同时操控内容。对于单人游戏体验，开发者应使用侧边栏。
• （推荐）该插件应显示已登录用户的身份。
• （推荐）本地化选项：语言应基于浏览器设置的本地偏好设置（如果有）。
• （推荐）应通过内容浏览界面选择内容，其中应显示最近访问的内容。
• （推荐）如果不再需要侧边栏，该插件应在启动到主舞台后关闭侧边栏。

日历插件

• 会议解决方案的徽标是公开网址。请参阅 提供会议解决方案徽标。
• 如果该插件使用 calendar.conferenceSolution，则会议解决方案的徽标应遵循 calendar.logoUrl 要求。请参阅 日历清单资源。
• 如果插件使用 calendar.logoUrl 或 common.logoUrl，徽标与应用详情中提供的图标相同。
• 如果该插件使用 calendar.logoUrl 或 common.logoUrl，徽标的网址开头如下：https://lh3.googleusercontent.com/

Meet 插件

• 插件品牌徽标的尺寸和样式应能让用户在 Meet 侧边栏中清晰辨识。
• 必须在插件清单中指定合适的深色模式徽标网址

云端硬盘插件

• （推荐）如果您想接收有限元数据，则该插件应包含 drive.addons.metadata.readonly 范围。

• 通用导航网址指向 Web 应用。没有任何功能的简单网页不属于 Web 应用。