# REST Resource: projects.deployments

- [Resource: Deployment](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Deployment)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Deployment.SCHEMA_REPRESENTATION)
- [DeploymentConfig](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#DeploymentConfig)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#DeploymentConfig.SCHEMA_REPRESENTATION)
- [EntryPoint](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPoint)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPoint.SCHEMA_REPRESENTATION)
- [EntryPointType](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPointType)
- [WebAppEntryPoint](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppEntryPoint)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppEntryPoint.SCHEMA_REPRESENTATION)
- [WebAppConfig](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppConfig)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppConfig.SCHEMA_REPRESENTATION)
- [Access](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Access)
- [ExecuteAs](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecuteAs)
- [ExecutionApiEntryPoint](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiEntryPoint)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiEntryPoint.SCHEMA_REPRESENTATION)
- [ExecutionApiConfig](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiConfig)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiConfig.SCHEMA_REPRESENTATION)
- [AddOnEntryPoint](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnEntryPoint)
  - [JSON representation](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnEntryPoint.SCHEMA_REPRESENTATION)
- [AddOnType](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnType)
- [Methods](https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#METHODS_SUMMARY)

## Resource: Deployment

Representation of a single script deployment.

| JSON representation |
|---|
| ``` { "deploymentId": string, "deploymentConfig": { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#DeploymentConfig`) }, "updateTime": string, "entryPoints": [ { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPoint`) } ] } ``` |

| Fields ||
|---|---|
| `deploymentId` | `string` The deployment ID for this deployment. |
| `deploymentConfig` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#DeploymentConfig`)`` The deployment configuration. |
| `updateTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Last modified date time stamp. 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"`. |
| `entryPoints[]` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPoint`)`` The deployment's entry points. |

## DeploymentConfig

Metadata the defines how a deployment is configured.

| JSON representation |
|---|
| ``` { "scriptId": string, "versionNumber": integer, "manifestFileName": string, "description": string } ``` |

| Fields ||
|---|---|
| `scriptId` | `string` The script project's Drive ID. |
| `versionNumber` | `integer` The version number on which this deployment is based. |
| `manifestFileName` | `string` The manifest file name for this deployment. |
| `description` | `string` The description for this deployment. |

## EntryPoint

A configuration that defines how a deployment is accessed externally.

| JSON representation |
|---|
| ``` { "entryPointType": enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPointType`), // Union field `properties` can be only one of the following: "webApp": { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppEntryPoint`) }, "executionApi": { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiEntryPoint`) }, "addOn": { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnEntryPoint`) } // End of list of possible types for union field `properties`. } ``` |

| Fields ||
|---|---|
| `entryPointType` | ``enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#EntryPointType`)`` The type of the entry point. |
| Union field `properties`. Entry point properties per entry point type. `properties` can be only one of the following: ||
| `webApp` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppEntryPoint`)`` An entry point specification for web apps. |
| `executionApi` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiEntryPoint`)`` An entry point specification for Apps Script API execution calls. |
| `addOn` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnEntryPoint`)`` Add-on properties. |

## EntryPointType

Types of entry points.

| Enums ||
|---|---|
| `ENTRY_POINT_TYPE_UNSPECIFIED` | An unspecified entry point. |
| `WEB_APP` | A web application entry point. |
| `EXECUTION_API` | An API executable entry point. |
| `ADD_ON` | An Add-On entry point. |

## WebAppEntryPoint

A web application entry point.

| JSON representation |
|---|
| ``` { "url": string, "entryPointConfig": { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppConfig`) } } ``` |

| Fields ||
|---|---|
| `url` | `string` The URL for the web application. |
| `entryPointConfig` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#WebAppConfig`)`` The entry point's configuration. |

## WebAppConfig

Web app entry point configuration.

| JSON representation |
|---|
| ``` { "access": enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Access`), "executeAs": enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecuteAs`) } ``` |

| Fields ||
|---|---|
| `access` | ``enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Access`)`` Who has permission to run the web app. |
| `executeAs` | ``enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecuteAs`)`` Who to execute the web app as. |

## Access

Access configuration.

| Enums ||
|---|---|
| `UNKNOWN_ACCESS` | Default value, should not be used. |
| `MYSELF` | Only the user who deployed the web app or executable can access it. Note that this is not necessarily the owner of the script project. |
| `DOMAIN` | Only users in the same domain as the user who deployed the web app or executable can access it. |
| `ANYONE` | Any logged in user can access the web app or executable. |
| `ANYONE_ANONYMOUS` | Any user, logged in or not, can access the web app or executable. |

## ExecuteAs

A configuration that specifies the user under whose authority the web app should run as.

| Enums ||
|---|---|
| `UNKNOWN_EXECUTE_AS` | Default value, should not be used. |
| `USER_ACCESSING` | The script runs as the user accessing the web app. |
| `USER_DEPLOYING` | The script runs as the user who deployed the web app. Note that this is not necessarily the owner of the script project. |

## ExecutionApiEntryPoint

An API executable entry point.

| JSON representation |
|---|
| ``` { "entryPointConfig": { object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiConfig`) } } ``` |

| Fields ||
|---|---|
| `entryPointConfig` | ``object (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#ExecutionApiConfig`)`` The entry point's configuration. |

## ExecutionApiConfig

API executable entry point configuration.

| JSON representation |
|---|
| ``` { "access": enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Access`) } ``` |

| Fields ||
|---|---|
| `access` | ``enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#Access`)`` Who has permission to run the API executable. |

## AddOnEntryPoint

An add-on entry point.

| JSON representation |
|---|
| ``` { "addOnType": enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnType`), "title": string, "description": string, "helpUrl": string, "reportIssueUrl": string, "postInstallTipUrl": string } ``` |

| Fields ||
|---|---|
| `addOnType` | ``enum (`https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments#AddOnType`)`` The add-on's required list of supported container types. |
| `title` | `string` The add-on's required title. |
| `description` | `string` The add-on's optional description. |
| `helpUrl` | `string` The add-on's optional help URL. |
| `reportIssueUrl` | `string` The add-on's optional report issue URL. |
| `postInstallTipUrl` | `string` The add-on's required post install tip URL. |

## AddOnType

AddType defines which category of add-ons a host application handles. Each add-on type has a section of the script manifest that is used when deploying or executing an add-on of the given type.

| Enums ||
|---|---|
| `UNKNOWN_ADDON_TYPE` | Default value, unknown add-on type. |
| `GMAIL` | Add-on type for Gmail. |
| `DATA_STUDIO` | Add-on type for Data Studio. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments/create` | Creates a deployment of an Apps Script project. |
| ### `https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments/delete` | Deletes a deployment of an Apps Script project. |
| ### `https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments/get` | Gets a deployment of an Apps Script project. |
| ### `https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments/list` | Lists the deployments of an Apps Script project. |
| ### `https://developers.google.com/apps-script/api/reference/rest/v1/projects.deployments/update` | Updates a deployment of an Apps Script project. |