Method: projects.deployments.list

  • This page describes how to list the deployments of an Apps Script project using a GET HTTP request.

  • The request requires ascriptId path parameter and can optionally includepageToken andpageSize query parameters.

  • The request body must be empty.

  • The response body contains a list of deployments and anextPageToken for pagination.

  • Authorization requires specific OAuth scopes for script deployments.

Lists the deployments of an Apps Script project.

HTTP request

GET https://script.googleapis.com/v1/projects/{scriptId}/deployments

The URL usesgRPC 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 ofnextPageToken from a previous response.

pageSize

integer

The maximum number of deployments 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 deployments for the specified Apps Script project.

JSON representation
{"deployments":[{object (Deployment)}],"nextPageToken":string}
Fields
deployments[]

object (Deployment)

The list of deployments.

nextPageToken

string

The token that can be used in the next call to get the next page of results.

Authorization Scopes

Requires one of the following OAuth scopes:

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

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.