Method: projects.versions.list

  • You can list the versions of a script project using a GET request to the specified URL.

  • The only required path parameter is scriptId, which is the script project's Drive ID.

  • Optional query parameters include pageToken for pagination and pageSize to limit the number of versions per page.

  • The request body should be empty.

  • The response body contains a list of versions and an optional nextPageToken for further pagination.

List the versions of a script project.

HTTP request

GET 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.

Query parameters

Parameters
pageToken

string

The token for continuing a previous list request on the next page. This should be set to the value of nextPageToken from a previous response.
pageSize

integer

The maximum number of versions on each returned page. Defaults to 50.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response with the list of the versions for the specified script project.

JSON representation 
{
  "versions": [
    {
      object (Version)
    }
  ],
  "nextPageToken": string
}
Fields
versions[]

object (Version)

The list of versions.
nextPageToken

string

The token use to fetch the next page of records. if not exist in the response, that means no more versions to list.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.