1

我开发了一个 Google 表格插件(侧边栏),现在正试图将它放到 Google Workspace Marketplace。

我对需要将OAuth 范围设置为用户同意屏幕和/或应用程序配置屏幕(和/或其他地方?)的一部分感到有点迷茫。

我有几个问题:

1.我实际需要设置的范围是什么

这就是添加做的:

  • 读取电子表格中的所有数据,基本上是读取权限,以分析公式单元格之间的引用(依赖项和先例)

  • 在用户批准后(每次单击按钮),它会将结果写入当前工作表中的新工作表。

  • 在内部错误的情况下并在用户批准后(每次单击按钮),插件会发送包含错误详细信息的电子邮件,包括堆栈跟踪和潜在的附加参数(电子表格和工作表名称)。

  • 日志是在运行期间写入的,用于调试和流程改进。日志记录可能包含一些电子表格基础数据

我找不到任何完整的范围列表,但我的理解是我至少需要:

https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/spreadsheets

2. 应该在哪里配置范围

我发现至少 3 个地方持有范围设置。

  • 在 Google Cloud Platform 控制台 ( API & Services -> OAuth consent screen)中的 OAuth 同意屏幕设置中

  • 如何发布指南中的#3导致Google Workspace 市场 SDK设置中的“应用程序配置”屏幕(请参见屏幕截图)我找不到到达此页面的方法,按照所述接受(在控制台中搜索Google Workspace 市场 SDK ) . 似乎它以某种方式隐藏......不太明白。此屏幕还具有 oAuth 范围设置。在此处输入图像描述

  • appscript.json文件,如此处所述。目前 appscript.json 没有任何范围引用。

4

1 回答 1

0

为了回答你的问题...

Apps 脚本最终会自动确定脚本需要的范围,并在脚本运行时添加它们。

要检查哪些已添加,您应该转到Apps 脚本项目中的概览,您将能够在项目 OAuth 范围部分下找到列表:

项目范围

因此,如果您已经运行并授权了插件对应的脚本,那么所需的范围将在那里添加。

至于范围列表,您可以在此处轻松查看此列表。

由于您正在开发编辑器插件,因此无需将范围也添加到清单文件中,除非您想设置显式范围。例如,如果您希望对附加组件进行更多控制并使用比自动添加的范围更严格的范围,则应在appsscript.json附加组件的清单文件中进行设置。

在 Apps 脚本端完成设置后,您可以开始使用 Marketplace SDK 配置插件。

这样做需要您提供您在 Apps 脚本项目中设置的 OAuth 范围的完整列表。您在此处输入的 OAuth 范围应与您在 OAuth 同意屏幕中显示的内容以及appssccript.json清单文件中的内容(如果适用)相匹配。

根据您为插件选择的范围和插件的可见性,您也可以考虑查看OAuth API 验证常见问题解答文档

以下 API 使用的某些范围被认为是敏感的;请参阅 API 文档或在 Cloud Console 中查找锁定图标。如果您的应用请求敏感范围,并且不符合任何例外条件(见下文),您将需要验证您的应用是否遵循 API 服务用户数据政策。

因此,如果您的附加组件使用此处列出的任何范围,则在公开发布之前,您还必须通过验证过程。

参考

于 2021-10-19T15:45:19.470 回答