Managing Deployments

AI-generated Key Takeaways

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

• You can create new deployments with specific code versions, manifests, and descriptions.

• The API allows listing, reading, updating, and deleting existing deployments for a script project.

• Updating a deployment involves modifying its description, version, or manifest.

• Deleting deployments can cause dependent add-ons or applications to fail, requiring caution.

This section provides an overview of the Apps Script API methods you can use to create, list, read, modify, and delete a script project's deployments.

API method overview
Create a deployment	projects.deployments.create Results: Create a new deployment for a script project. You specify the code version, the manifest file, and deployment description to use. Returns a Deployment object, containing the deployment configuration details.
List a project's deployments	projects.deployments.list Results: Returns an array of Deployment objects, each representing one of the deployments of the script project.
Read a deployment	projects.deployments.get Results: Returns a Deployment that represents a specific deployment in a specific script project.
Update a deployment	projects.deployments.update Results: Changes a deployment's description, code version, or the manifest where the deployment is defined.
Delete a deployment	projects.deployments.delete Results: Removes a deployment. Warning: Deleting a deployment causes any add-on, web app, or other application that makes use of that deployment to lose access to the Apps Script project, usually causing them to fail. Do not delete a deployment without first updating any apps that depend on it.