Apps 脚本信息中心

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

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

查看和搜索项目

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

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

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

查看项目详情

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

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

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

项目的每个部署都会以标签页的形式显示在 Project Details 页面上的数据和图表上方;您可以选择该标签页来查看该部署关联的数据。如果选择全部,则系统将显示项目的所有部署的汇总数据,以及来自在 Apps 脚本代码编辑器中运行项目的开发者执行的执行作业。

监控项目

与您定期使用或管理的 Apps 脚本项目相比,您可以访问的 Apps 脚本项目数量明显多于您定期使用或管理的项目。要为项目添加书签以便于访问,您可以为其加注星标。 通过为项目加星标,您还可以监控这些项目的汇总使用情况和错误率统计信息和图表。

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

在左侧的导航栏中,您可以选择已加星标的项目,以查看已添加书签的项目。点击页面顶部的错误率执行用户统计信息摘要,以查看过去 7 天内所有已加星标的项目的关联图表。

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

管理执行任务

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

My Executions 面板默认显示由您担任所有者、编辑者或查看者的项目之前和当前正在运行的所有执行任务的日志。如果以您的名义运行,您无权访问的项目中的函数执行情况(例如您已安装和运行的插件)。执行列表仅显示为开始执行而调用的初始函数。但不会显示在该执行期间调用的每个函数。

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

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

类型列会显示发起执行的原因。 相关的值包括:

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

终止执行

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

设置

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

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

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

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