Google Apps 脚本信息中心

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

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

查看和搜索项目

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

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

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

查看项目详情

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

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

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

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

以插件形式发布的项目不会在 Apps 脚本信息中心内显示为已部署。

监控项目

为项目加注星标,以便将其添加为书签。为项目加星标后,您还可以监控汇总的使用情况和错误率统计信息及图表。

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

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

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

管理执行

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

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

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

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

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

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

终止执行

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

设置

如需调整信息中心设置,请选择左侧导航栏中的设置

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

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

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