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

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

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

• 每次用户开始私信对话或应用被添加到聊天室时，应用都会主动发送欢迎消息。欢迎消息与“帮助”命令不同。查看文档。
• 该应用支持“帮助”指令，可帮助用户入门。 查看文档。
• 当用户在聊天室或直接 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 个字符。

• 该插件使用正确的界面元素（例如 widget 或 Meet 插件中的 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 一键登录中找到的一键登录提示，以及身份验证中找到的“使用 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 应用。