如何创建集成Drive UI「Open With Menu」的Google Workplace Add-on并实现跳转与发布？

一、基础配置：启用Drive API并设置OAuth权限 #

1. 在Google Cloud控制台打开你的项目，启用Drive API
2. 配置OAuth consent screen，添加必要的权限范围：
   • 最小权限推荐：https://www.googleapis.com/auth/drive.file（仅访问用户授权的文件）
   • 若需读取文件元数据，可补充https://www.googleapis.com/auth/drive.metadata.readonly
3. 创建OAuth客户端ID，确保与你的Workplace Add-on使用同一客户端ID（或关联同一项目）

二、配置Drive「Open with」集成 #

这是核心步骤，直接决定Drive中是否显示你的应用选项：

1. 在Google Cloud控制台的Drive API配置页面，找到Drive UI Integration模块
2. 开启「Open with」功能，填写以下关键信息：
   • 应用名称：显示在Drive「Open with」菜单中的名称（建议与Add-on名称一致）
   • 图标：上传或填写应用图标的HTTPS地址（用于菜单显示）
   • 支持的MIME类型：勾选或输入你的应用能处理的文件类型，比如谷歌文档(application/vnd.google-apps.document)、PDF(application/pdf)等
   • 打开URL：用户点击「Open with」后跳转的自有应用地址，可使用动态参数获取Drive信息：
     • {ids}：当前选中的文件ID列表（逗号分隔）
     • {userId}：当前用户的Google ID
     • {folderId}：文件所在文件夹ID（可选）
3. 保存配置，等待Google同步（通常几分钟内生效）

三、关联Workplace Add-on的权限与集成 #

1. 在你的Add-on的appsscript.json（Manifest文件）中，确保已声明Drive相关的权限范围（与步骤一中的范围一致）
2. 当用户安装Add-on并授权时，会自动关联到你配置的Drive集成，此时用户的Drive中就会显示你的应用「Open with」选项

四、自有应用的跳转处理 #

1. 当用户从Drive跳转至你的应用时，你的服务端需要解析URL中的参数（比如ids）
2. 使用用户的OAuth凭证（可通过Add-on授权后传递，或让用户在自有应用中复用已授权的会话）调用Drive API，获取文件的内容或元数据
3. 处理文件逻辑，比如展示内容、编辑等

关键注意事项 #

• 权限遵循最小化原则：避免请求不必要的大范围权限，否则Google验证应用时会更严格
• 未验证应用仅对测试用户可见：在OAuth consent screen中添加测试用户后，才能正常测试「Open with」功能
• 跳转URL必须是HTTPS：Google不允许HTTP地址作为跳转目标
• 文件类型匹配准确：只有配置的MIME类型对应的文件，才会显示你的应用选项

内容的提问来源于stack exchange，提问作者Vignesh T