Apps 脚本信息中心

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

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

查看和搜索项目

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

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

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

查看项目详情

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

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

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

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

监控项目

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

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

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

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

管理执行

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

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

您可以使用该视图顶部的过滤器来控制在日志中报告哪种类型的执行。日志的每一行代表一次执行。Start TimeDurationStatus 列显示有关执行的相应信息。

函数列显示了启动执行的函数的名称。如果您无权访问执行的对应脚本项目,但脚本项目以您的名义运行,则此列中没有名称。

类型列会显示执行是由什么类型发起的。 相关的值包括:

  • 插件。执行源自插件。
  • Execution API。执行源自 Apps Script API 的调用。
  • 时间驱动。执行由时间事件导致。
  • 触发器。执行源自触发器来源。
  • Webapp。执行源自部署的 Web 应用。
  • 编辑者。执行源自 Apps 脚本编辑器。

终止执行

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

设置

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

“设置”面板中是 Apps Script API 的切换开关。这样,您就可以向 API 授予脚本项目访问权限

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

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