REST Resource: projects

  • This documentation details the Apps Script API for managing script projects, including creating, retrieving, and updating projects and their content.

  • A script project is represented by properties like script ID, title, parent ID, creation and update timestamps, and creator/modifier user details.

  • User profiles associated with script projects contain domain, email, name, and photo URL information.

  • The API provides methods to manage script projects: create, get, getContent, getMetrics, and updateContent.

Resource: Project

The script project resource.

JSON representation 
{
  "scriptId": string,
  "title": string,
  "parentId": string,
  "createTime": string,
  "updateTime": string,
  "creator": {
    object (User)
  },
  "lastModifyUser": {
    object (User)
  }
}
Fields
scriptId

string

The script project's Drive ID.
title

string

The title for the project.
parentId

string

The parent's Drive ID that the script will be attached to. This is usually the ID of a Google Document or Google Sheet. This filed is optional, and if not set, a stand-alone script will be created.
createTime

string (Timestamp format)

When the script was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

When the script was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
creator

object (User)

User who originally created the script.
lastModifyUser

object (User)

User who last modified the script.

User

A simple user profile resource.

JSON representation 
{
  "domain": string,
  "email": string,
  "name": string,
  "photoUrl": string
}
Fields
domain

string

The user's domain.
email

string

The user's identifying email address.
name

string

The user's display name.
photoUrl

string

The user's photo.

Methods

create

 Creates a new, empty script project with no script files and a base manifest file.

get

 Gets a script project's metadata.

getContent

 Gets the content of the script project, including the code source and metadata for each script file.

getMetrics

 Get metrics data for scripts, such as number of executions and active users.

updateContent

 Updates the content of the specified script project.