如果您已构建并发布了用于扩展 Gmail 或日历的插件,则可以将其升级为 Google Workspace 插件。本页中的说明详细介绍了如何将 Google Workspace 功能添加到现有的 Gmail 或 Google 日历插件中,然后发布升级后的插件,以便用户发现和安装。
您可以将新功能转移到原始插件中,以保留您的 Google Workspace Marketplace 商品详情、安装量和用户。升级后,您还可以利用新的 Google Workspace 附加功能,例如首页。
第 1 步:复制插件的 Apps 脚本项目
升级后的插件会使用与已发布的插件相同的 Google Cloud 项目,但务必创建并使用基础 Apps 脚本项目的副本,以免现有用户在测试升级版本时受到影响。升级原始脚本项目的副本还意味着您始终可以访问原始代码,并可以稍后重新部署(如果需要)。
- 打开现有的 Gmail 插件或日历会议插件 Apps 脚本项目。
- 点击左侧的概览 。
- 点击右侧的“复制”图标 。
- 在左侧,依次点击项目设置 > 更改项目。
- 点击 GCP 项目编号。
- 输入与现有已发布的插件 Apps 脚本项目关联的同一项目编号。
- 点击设置项目。
第 2 步:集成 Google Workspace 附加功能
您必须设计和实现任何要添加到插件的附加功能。 Google Workspace
- 规划要在插件的首页卡片中显示哪些内容,以及这些内容应显示在 Gmail、Google 日历、云端硬盘还是三种主机的任意组合中。如果您希望一个首页在多个主机中,请确定它是否可以是同一个首页,或者您是否想要为每个主机使用自定义首页卡片。
- 在复制的插件 Apps 脚本项目中,使用
homepageTrigger
函数构建首页卡片。请务必提供所需的任何支持函数或逻辑来控制新的首页界面。 考虑添加用户的操作触发的上下文卡片,例如打开 Gmail 邮件会话或日历活动。
请更新插件(在微件回调函数或上下文触发器函数中)中对事件对象的所有访问权限,以使用更新后的事件对象结构。 新结构仍然包含 Gmail 和 Google 日历会议插件使用的相同事件对象字段,但这些原有字段已废弃,最终将被移除。
第 3 步:更新插件的清单
Google Workspace 插件清单结构中存储配置信息的方式与 Gmail 插件和日历会议插件所使用的结构相比发生了很大变化。升级插件时,您必须根据下表更新 Apps 脚本项目的清单字段。您必须将所有相关子属性更新为新的 addOns
属性。
此外,请务必根据需要更新清单的 oauthScopes
字段,以反映更新后的插件所需的权限。
如需详细了解插件清单 Google Workspace ,请参阅清单。
Gmail 插件
原始清单字段 | 需要执行相关操作 |
---|---|
gmail.composeTrigger |
移至 addOns.gmail.composeTrigger 。 |
gmail.contextualTriggers[] |
将列表移至 addOns.gmail.contextualTriggers[] 。 |
gmail.logoUrl |
移至 addOns.common.logoUrl 。 |
gmail.name |
移至 addOns.common.name 。 |
gmail.openLinkUrlPrefixes[] |
将列表移至 addOns.common.openLinkUrlPrefixes[] 。
|
gmail.primaryColor |
移至 addOns.common.layoutProperties.primaryColor 。 |
gmail.secondaryColor |
移至 addOns.common.layoutProperties.secondaryColor 。
|
gmail.universalActions[] |
将列表移至 addOns.common.universalActions[] 。 |
gmail.universalActions[].text |
将每个 gmail.universalActions[].text 字段移至相应的 addOns.common.universalActions[].label 字段。 |
gmail.useLocalFromApp |
移至 addOns.common.useLocaleFromApp 。 |
Google 日历会议插件
原始清单字段 | 需要执行相关操作 |
---|---|
calendar.createSettingsUrlFunction |
移至 addOns.calendar.createSettingsUrlFunction 。 |
calendar.conferenceSolution[] |
移至 addOns.calendar.conferenceSolution[] 。 |
calendar.logoUrl |
移至 addOns.common.logoUrl 。 |
calendar.name |
移至 addOns.common.name 。 |
第 4 步:测试已升级的插件
如需在发布之前测试已升级的插件,请参阅测试 Google Workspace 插件。
第 5 步:申请审核升级后的插件
所有插件 Google Workspace 无论是升级后的插件还是从头开始构建的插件,都必须获得批准,然后才能在 Google Workspace 市场中上架。
请按照以下步骤提交插件以供审核:
确保您的插件符合所有插件发布要求。
使用要发布的代码版本,为插件(在新 Apps 脚本项目中)创建版本化部署。不要尝试使用 Head 部署进行发布。
如果您在升级插件时添加了新范围,则必须请求 OAuth 验证。例如,如果您的 Gmail 插件在Google Workspace 插件版本中使用了新的云端硬盘或日历范围,那么您必须提交这些新范围进行验证。验证通常需要几天的时间才能完成,因此请尽早开始该流程。在继续执行第 6 步之前,请确保插件已经过验证。
第 6 步:提供升级后的插件
打开 Google Workspace Marketplace SDK。
点击左侧的 Configuration(配置)。此面板包含一个表单,您可以在其中提供插件的相关信息。
更新商品详情的简短说明、详细说明和屏幕截图,以反映插件的新功能 Google Workspace 。
在扩展程序下,点击升级到Google Workspace 插件按钮。在显示的文本框中,输入您在 Google Workspace 上一步中为插件创建的新部署 ID。如果您的部署 ID 有效,则会显示受支持的主机列表。
如果您向插件中添加了 Google Workspace 新的范围,请务必将其添加到 Configuration 页面的 OAuth 2.0 范围部分。该部分列出的范围应与插件清单中列出的范围完全匹配。
验证您在表单中输入的信息是否正确。然后,点击保存更改。
在此附加服务升级过程中,如果您有任何疑问或遇到问题,请 Google Workspace 与我们联系。
常见问题解答
以下是有关插件升级的常见问题:
我可以升级编辑器插件吗?
大多数编辑器插件都可以 Google Workspace 迁移到插件。但是,它们不能像 Gmail 和 Google 日历这样的插件那样 Google Workspace 升级为插件。
如果您想将编辑器插件迁移到 Google Workspace 插件,则需要将插件的界面从 HTML 重写为基于卡片的界面,并将 JavaScript 处理更新为卡片服务。
现有编辑器插件中的部分服务可能无法在银行卡服务中使用。例如,如果您的编辑器插件包含文件选择器,就没有与卡片服务相同的插件插件。 Google Workspace
我可以构建单独的插件 Google Workspace 并保留现有的插件吗?
欢迎您为不同的品牌名称 Google Workspace 开发其他插件,但我们不允许使用与您的品牌插件相同的品牌名称。 Google Workspace 如果您有疑问或想要申请豁免,请与我们联系。
插件升级后,我的用户需要重新为其授权吗?
只要您的插件使用相同的基础 Cloud Platform (GCP) 项目 Google Workspace (带有关联的 OAuth 客户端 ID),您的用户就无需重新授权之前为原始插件授权的权限。但是,如果您在升级过程中添加了新范围,则您的用户必须在首次使用插件的 Google Workspace版本时授权这些新范围。
我可以将 Chrome 扩展程序升级为 Google Workspace 插件并转移用户吗?
不可以。您无法转移 Chrome 扩展程序的用户、安装和商家信息评价。您必须创建新的插件 Google Workspace 并将您的 Chrome 扩展程序用户定向到 Google Workspace Marketplace。
我可以将多个插件与 Google Workspace 插件绑定吗?
请参阅同时列出应用集成。