借助 Apps 脚本信息中心,您可以 管理和监控 Apps 脚本项目。您可以使用信息中心执行以下操作:
- 查看和搜索现有的 Apps 脚本项目, 包括绑定到 Google Workspace 文档的脚本。
- 创建新项目。
- 查看项目的详细信息,例如项目使用的 OAuth 范围。
- 监控脚本项目的运行状况和使用情况。
- 查看项目的执行日志,以及使用您账号凭据运行的其他项目的执行日志。
- 开启或关闭 Apps 脚本 API ,以允许或阻止应用使用该 API 与您的脚本 项目互动。
查看和搜索项目
Apps 脚本信息中心会列出您可以查看或修改的所有脚本项目。信息中心的左侧导航栏会将这些项目划分为以下类别:
- 加注星标的项目 。您正在监控的项目。
- 我的项目 。您是所有者的项目。
- 所有项目 。您拥有或具有查看或修改权限的项目。
- 与我共享 。您不拥有但已与您共享的项目。
- 回收站 。您已从 Google 云端硬盘中移除的项目。
项目列表会显示项目名称、所有者和上次修改日期。项目名称旁边的图标表示项目是 独立项目还是 绑定项目。
查看项目详情
每个项目都包含一个视图,用于查看项目的开发者详细信息。如需查看项目的详细信息,请点击项目列表中的相应行。
项目详情视图会显示项目的错误率、执行次数和用户数 数据和图表,以及向项目的所有用户请求的OAuth 范围。数据指标的定义如下:
- 错误率 。由于未捕获的异常而未能运行的执行所占的百分比。计算方法为:失败的执行次数除以定义的时间段内的总执行次数。
- 执行次数 。项目“运行”或执行的次数。 如需详细了解如何运行 项目,请参阅执行类型。
- 用户数 。在指定时间段内运行项目一次或多次的唯一身份用户账号的数量。系统不会跟踪匿名用户,因此用户数或图表中不会反映匿名用户。
项目的每次部署都会显示为项目详情 页面上数据和图表之前的标签页;选择该标签页即可查看该部署的相关数据。选择全部 可显示项目的所有部署的汇总数据,以及开发者从 Apps 脚本代码编辑器中运行项目所产生的执行的汇总数据。
作为插件发布的项目不会在 Apps 脚本信息中心内显示为已部署。
监控项目
为项目加注星标,以便将其加入书签。为项目加注星标后,您还可以监控汇总使用情况和错误率统计信息及图表。
如需为项目加注星标,请点击项目行右侧的“更多”图标 > 加注星标。您还可以在 查看项目详情时点击“更多”图标 ,为项目加注星标。
在左侧导航栏中,选择加注星标的项目 ,即可查看您已加入书签的项目。点击页面顶部的错误率、执行次数或用户数记分卡,即可查看过去 7 天内所有加注星标项目的相关图表。
如需移除项目的星标,请点击项目行中的“更多”图标 ,然后选择 移除星标。
管理执行
您可以使用 Apps 脚本信息中心查看和管理 Apps 脚本项目函数的各个执行。如需查找最近执行的完整日志,请在左侧导航栏中选择我的执行 。
我的执行 面板会显示您是所有者、编辑者或查看者的项目的所有先前执行和正在运行的执行的日志。此列表还可以包含您无权访问的项目中的函数执行(如果这些函数代表您运行,例如您已安装并运行的插件)。执行列表仅显示用于启动执行的初始函数, 而不显示该执行期间调用的每个函数。
您可以使用视图顶部的过滤条件控制日志中报告的执行类型。日志的每一行都代表一次执行。 **开始时间** 、**时长** 和**状态** 列会显示有关该执行的相应 信息。
函数 列会显示启动执行的函数的名称。如果您无权访问执行的相应脚本项目,但该项目代表您运行,则此列中不会显示名称。
类型 列会显示启动执行的内容。相关的值包括:
- 插件 。执行源自插件。
- Execution API 。执行源自对 Apps 脚本 API 的调用。
- 时间驱动 。执行由时间事件引起。
- 触发器 。执行源自触发器来源。
- Web 应用 。执行源自已部署的 Web 应用。
- 编辑器 。执行源自 Apps 脚本编辑器。
终止执行
正在进行的长时运行执行会以“正在运行”状态 表示。如需停止这些执行,请点击项目行右侧的 更多 > 终止。
设置
如需调整信息中心设置,请在左侧导航栏中选择设置 。
在 设置 面板中有一个 Apps 脚本 API 的切换开关。您可以使用此开关向 API 授予对脚本项目的访问权限 。
如需访问此切换开关,请点击设置 面板中的 Google Apps 脚本 API 标签。系统会打开一个新面板,其中包含警告文本和一个切换开关。出于安全考虑,系统默认关闭对脚本项目的访问权限。授予访问权限后,您授权的任何第三方应用都可以使用该 API 修改您的脚本和部署。您可以随时在设置 面板中撤消此访问权限。
如需了解详情,请参阅Apps 脚本 API 访问权限指南。