管理项目

本部分简要介绍了可用于创建、读取、修改和监控 Apps Script 项目的 Apps Script API 方法。项目管理示例页面显示了 API 管理请求示例。每个方法的参考文档都提供了实现详情。

API 方法概览
创建项目

projects.create

结果:创建一个基本空项目,其中没有项目文件和默认的项目清单

选项:您可以提供项目标题。您还可以通过提供 Google 文档、Google 表格、Google 表单或 Google 幻灯片文件的 Google 云端硬盘 ID 来创建绑定脚本,以用作脚本的父级。

读取项目元数据

projects.get

结果:检索 Project 对象,该对象表示项目元数据。这些数据包括项目标题、脚本 ID、创建者、创建时间和其他详细信息。

阅读项目内容

projects.getContent

结果:返回一个 File 对象数组,每个项目中的代码和 HTML 文件对应一个。该列表还包含作为 JSON 文件的项目清单。文件对象包含文件的源内容 (File.source) 和其他元数据,例如文件中的函数列表 (File.functionSet)。

选项:您可以使用查询参数指定要检索的内容的版本

更新项目内容

projects.updateContent

结果:更改脚本项目中的文件内容。 您可以将新内容作为 File 对象数组提供。其中一个 File 对象必须是 JSON 类型,并表示脚本项目的新项目清单。新内容会存储为项目的 HEAD 版本。当脚本在脚本编辑器中、插件预览模式下或开发模式下作为触发器执行时,就会使用此参数。

注意:更新脚本项目内容时,常见做法是先发出 projects.getContent 请求以检索现有 File 的数组,对这些对象执行所需操作,然后将 File 用作 projects.updateContent 请求的输入。

警告:新内容会替换脚本项目中的所有现有文件。系统会移除未通过请求更新的文件。

读取项目指标

projects.getMetrics

结果:读取与项目相关的特定指标。 这些指标包括用户数、执行总数、执行错误总数和其他详细信息。 使用 MetricType 指定您请求的信息。

选项:使用 MetricsFilter 将结果限制为特定部署或脚本函数。 您还可以使用 MetricsIntervalConfig 定义特定的指标间隔时间。