Apps 脚本信息中心

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

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

查看和搜索项目

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

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

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

查看项目详情

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

项目详细信息视图显示错误率执行用户数据、有关该项目的图表,以及针对使用该项目的任何最终用户请求的 OAuth 范围。数据指标的定义如下:

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

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

监控项目

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

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

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

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

管理执行

您可以使用 Apps 脚本信息中心查看和管理 Apps 脚本项目函数的各次执行。您可以选择左侧导航栏中的我的执行作业,查看近期执行作业的完整日志。

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

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

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

类型列显示了发起执行的操作。相关的值包括:

  • 添加开启。执行源自插件。
  • Execution API。该执行源自对 Apps Script API 的调用。
  • 按时间。执行是由时间事件触发的。
  • 触发器。执行来自触发器来源。
  • Webapp。执行操作源自已部署的 Web 应用。
  • 编辑者。执行源自 Apps 脚本编辑器。

终止执行

当前正在进行的长时间运行作业的 Status 为“Running”。如需停止这些执行作业,请在项目行的右侧依次点击“更多”图标 > 终止

设置

您可以通过选择左侧导航栏中的设置来调整信息中心设置。

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

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

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