Method: projects.versions.create

  • A new immutable version of a script project is created using a POST request to a specific URL.

  • The request requires ascriptId as a path parameter to identify the project.

  • The request body is a JSON object containing optional fields likeversionNumber,description, andcreateTime for the new version.

  • A successful response returns a newly created Version object.

  • Authorization requires thehttps://www.googleapis.com/auth/script.projects OAuth scope.

Creates a new immutable version using the current code, with a unique version number.

HTTP request

POST https://script.googleapis.com/v1/projects/{scriptId}/versions

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
scriptId

string

The script project's Drive ID.

Request body

The request body contains data with the following structure:

JSON representation
{"versionNumber":integer,"description":string,"createTime":string}
Fields
versionNumber

integer

The incremental ID that is created by Apps Script when a version is created. This is system assigned number and is immutable once created.

description

string

The description for this version.

createTime

string (Timestamp format)

When the version 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".

Response body

If successful, the response body contains a newly created instance ofVersion.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/script.projects

For more information, see theOAuth 2.0 Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-10-31 UTC.