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 a scriptId as a path parameter to identify the project.

  • The request body is a JSON object containing optional fields like versionNumber, description, and createTime for the new version.

  • A successful response returns a newly created Version object.

  • Authorization requires the https://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 uses gRPC 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月02日T15:01:23Z" and "2014年10月02日T15:01:23.045123456Z".

Response body

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

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

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

Last updated 2024年10月31日 UTC.