Managing Versions

AI-generated Key Takeaways

• This section explains how to manage Apps Script project versions using the Apps Script API.

• You can create new versions, which are immutable snapshots of your project's code.

• The API allows you to list all existing versions and retrieve details about a specific version.

• Version information is returned as Version objects, and you can access the code itself using projects.getContent.

This section provides an overview of the Apps Script API methods you can use to create a new project code version, read version information, or list all existing versions.

Note: These methods return one or more Version objects which contain the version configuration information such as the version number and description. You can read the code attached to a specific version using a projects.getContent request.

API method overview
Create a version	projects.versions.create Results: Create a new, immutable version of a script project's code. The project's current saved code is used for the version. This creates a code "snapshot" you can read later or use in a specific deployment. Returns a Version object, containing the version configuration details.
List a project's versions	projects.versions.list Results: Returns an array of Version objects, each representing one of the versions of the script project.
Read a version	projects.versions.get Results: Returns a Version that represents a specific version of a script project.