Apps 脚本信息中心

借助 Apps 脚本信息中心,您可以管理和监控 Apps 脚本项目。您可以使用该信息中心执行以下任意操作:

  • 查看和搜索您现有的 Apps 脚本项目,包括附加到Google Workspace 文档的绑定脚本。
  • 创建新项目。
  • 查看有关项目的详细信息,例如项目使用的 OAuth 范围
  • 监控脚本项目的健康状况和使用情况。
  • 查看项目以及使用您账号的凭据运行的其他项目的执行日志。
  • 开启或关闭 Apps Script API,以允许或阻止应用使用该 API 与您的脚本项目互动。

查看和搜索项目

Apps 脚本信息中心会列出您可以查看或修改的所有脚本项目。信息中心的左侧导航栏将这些项目分为以下几类:

  • 已加星标的项目。您正在监控的项目。
  • 我的项目。您是所有者的项目。
  • 所有项目。您拥有或有权查看或修改的项目。
  • 与我共享。您不拥有但已与您共享的项目。
  • 回收站。您已从 Google 云端硬盘中移除的项目。

项目列表会显示项目名称、所有者和上次修改日期。项目名称旁边的图标表示项目是独立项目还是绑定项目。

查看项目详情

每个项目都包含一个视图,用于查看项目的开发者详细信息。如需查看项目的详细信息,请点击项目列表中的相应行。

项目详情视图会显示项目的错误率执行次数用户数据和图表,以及使用该项目的任何最终用户请求的 OAuth 范围。数据指标的定义如下:

  • 错误率。因未捕获的异常而未能运行的执行所占的百分比。计算方法为:在指定时间段内,失败的执行次数除以总执行次数。
  • 执行。项目被“运行”或执行的次数。 如需详细了解如何运行项目,请参阅执行类型
  • 用户。在指定时间段内运行过一次或多次项目的唯一身份用户(账号)数量。系统不会跟踪匿名用户,因此用户数量或图表中不会显示匿名用户。

项目的每次部署都会显示为项目详情页面上数据和图表上方的标签页;您可以选择相应标签页来查看该部署的相关数据。选择 ALL 可显示项目的所有部署的汇总数据,以及开发者在 Apps 脚本代码编辑器中运行项目所产生的执行数据。

监控项目

您可能有权访问比您经常使用或管理的 Apps 脚本项目多得多的项目。如需为项目添加书签以便轻松访问,您可以为项目加星标。 为项目加星标后,您还可以监控这些项目的汇总使用情况和错误率统计信息及图表。

如需为项目加星标,请点击项目行右侧的“更多”图标 > 添加星标。您还可以在查看项目详情时点击“更多”图标 为项目加星标。

在左侧导航栏中,您可以选择已加星标的项目,查看已添加书签的项目。点击页面顶部的错误率执行次数用户数得分卡,即可查看过去 7 天内所有加星标项目的相关图表。

如需移除项目的星标,请点击相应项目行中的“更多”图标 ,然后选择移除星标

管理执行

您可以使用 Apps 脚本信息中心查看和管理 Apps 脚本项目函数的各个执行情况。您可以在左侧导航栏中选择我的执行记录,查看最近执行的完整日志。

默认情况下,我的执行记录面板会显示您作为所有者、编辑者或查看者的项目的所有先前执行记录和当前正在运行的执行记录的日志。如果项目中的函数执行是代表您运行的(例如,您已安装并运行的插件),即使您无权访问这些项目,此列表也可能包含这些项目中的函数执行。执行列表仅显示用于启动执行的初始函数。它不会显示在执行期间调用的每个函数。

您可以使用视图顶部的过滤条件来控制日志中报告的执行类型。日志的每一行都代表一次执行。开始时间时长状态列会显示相应执行的相关信息。

函数列显示启动执行的函数的名称。如果您无权访问执行操作的相应脚本项目,但该脚本项目是代表您运行的,则此列中不会显示名称。

类型列显示了执行的启动方式。 相关的值包括:

  • 加购项。执行源自插件。
  • Execution API。执行源自对 Apps 脚本 API 的调用。
  • 时间驱动。执行是由时间事件引起的。
  • 触发器。执行源自触发源。
  • Webapp。执行源自已部署的 Web 应用。
  • 编辑者。执行源自 Apps 脚本编辑器。

终止执行

当前正在进行中的长时间运行的执行作业会以“正在运行”的状态表示。如需停止这些执行,请点击项目行右侧的“更多”图标 > 终止

设置

您可以在左侧导航栏中选择设置,以调整信息中心设置。

设置面板中,有一个用于 Apps Script API 的切换开关。这样一来,您就可以向 API 授予对脚本项目的访问权限

如需访问此切换开关,请点击设置面板中的 Google Apps Script API 标签。系统会打开一个新面板,其中包含警告文本和一个切换开关。出于安全考虑,系统默认会关闭对脚本项目的访问权限。授予访问权限后,您授权的任何第三方应用都可以使用该 API 修改您的脚本和部署。您可以随时在设置面板中撤消此访问权限。

如需了解详情,请参阅 Apps 脚本 API 访问指南