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

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

• 每当用户发起私信或应用被添加到聊天室时，应用都会发送一条无提示的欢迎辞。欢迎辞与“帮助”命令不同。如需详细了解如何创建良好的欢迎辞，请参阅 构建聊天应用，帮助用户提升和愉悦。
• 此应用支持“帮助”命令，有助于用户开始使用应用。如需详细了解如何创建实用的帮助消息，请参阅 构建能够为用户带来和带来愉悦体验的聊天应用。
• 在聊天室或直接 Chat 中向应用发消息时，应用一律会回复。
• 消息使用正确的拼写、大小写、标点和语法。消息不包含恶意、冒犯性或侮辱性内容。
• 根据 Google 的要求，“信息”应用对文字或卡片使用清晰、简洁且一致的格式。
• 如果响应时间超过 2 秒，应用会发送一条说明延迟的消息。
• 发送通知的应用允许用户关闭通知。
• 用户可以使用“@”提及应用，从而将应用添加到聊天室。
• 用户可以使用查看成员菜单从聊天室中移除应用。
• 应用会向用户指明与其互动所需的所有内容。
• 应用使用的卡片格式符合 Google 的要求。请参阅 创建互动卡片。
• 用户可通过“聊天”菜单中的查找应用选项访问应用。
• 应用与之交互的外部网址不属于预演或开发环境。
• 在聊天室中，发送到应用的每条消息中都必须用“@”提及。 只有这样，应用知道自己必须做出响应。
• 如果 Chat 应用预览来自第三方网域的链接：
  • 链接预览可为用户提供消息的相关补充信息。例如，预览销售交易的链接会添加帐号、金额和阶段等信息。
  • 开发者隶属于所预览的网域。

  如需了解详情，请参阅预览链接。

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

• 应用具有可识别身份且清晰的头像。

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

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

• 该插件包含预期操作和必需操作，并提供完成其工作流所需的所有工具。例如：
  • 如果插件将样式应用于整个文档，则它会提供将样式仅应用于所选文本的选项。
  • 如果该插件将电子表格数据上传到网络服务 Feed，则会包含指向该 Feed 的链接，以便用户轻松导航。
  • 如果插件要求用户有帐号，它会提供链接或信息，以便用户轻松创建帐号（如果用户还没有帐号）。
• 该插件的插件标签页下有菜单项。
• 即使该插件只是自定义函数，它仍然包含适当的文档。
• 插件正确使用 onInstall() 和 onOpen() 来填充其菜单。首次安装插件以及打开其他文件时，系统会填充菜单项。请参阅 编辑器插件授权。
• 授权模式设置正确。请参阅 授权模式。

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

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

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

日历插件

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

• 插件使用正确的 widget 实现所需功能。例如，使用开关来选择布尔值。

日历插件

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

Gmail 插件

如果该插件使用 UrlFetchApp 或 OpenLinkUrl：

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

• 该插件有一个首页。如果您的 Google Workspace 插件是转换后的 Gmail 插件，系统会应用默认首页。
• 插件卡片能正常使用。例如，没有重复的卡片；返回、刷新和更新按钮的功能会相应地运作。
• 插件在用户授权后，会显示自定义首页卡片来欢迎用户，并提供登录按钮（如果需要）、徽标和该插件的简要说明。
  • 如果登录按钮被触发，则会显示第三方供应商提供的自定义登录页面，其中清楚地指明有第三方服务在 Google Workspace 之外运行。
• 该插件的界面会整洁地放置在分配的空间中：
  • 文本和标签不会因“...”被截断
  • 用户无需执行太多垂直滚动操作。
  • 内容宽度未超过 300p，因此没有水平滚动条。
• 插件的代码不会过度使用库，因为库可能会导致插件性能下降。

日历插件

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

文档插件

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

• 链接预览可为用户提供相关的补充信息。 例如，预览销售交易的链接会添加帐号、金额和阶段等信息。
• 开发者隶属于所预览的网域。

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

云端硬盘插件

• 如果应用将文件存储在云端硬盘中，则允许用户选择一个文件夹或创建和重复使用应用专用文件夹。配置数据存储在应用数据文件夹中。应用不会将文件转储到用户的“我的云端硬盘”文件夹中。
• 该插件只会将与该插件所载述功能相关联的文件存储在云端硬盘中。

Gmail 插件

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

日历插件

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

云端硬盘插件

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

• 通用导航网址指向 Web 应用。没有功能的简单网页不会被视为 Web 应用。