REST Resource: projects.deployments  |  Apps Script  |  Google for Developers (original) (raw)

Resource: Deployment

Representation of a single script deployment.

JSON representation
{ "deploymentId": string, "deploymentConfig": { object (DeploymentConfig) }, "updateTime": string, "entryPoints": [ { object (EntryPoint) } ] }
Fields
deploymentId string The deployment ID for this deployment.
deploymentConfig object (DeploymentConfig) The deployment configuration.
updateTime string (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 (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 (EntryPointType), // Union field properties can be only one of the following: "webApp": { object (WebAppEntryPoint) }, "executionApi": { object (ExecutionApiEntryPoint) }, "addOn": { object (AddOnEntryPoint) } // End of list of possible types for union field properties. }
Fields
entryPointType enum (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 (WebAppEntryPoint) An entry point specification for web apps.
executionApi object (ExecutionApiEntryPoint) An entry point specification for Apps Script API execution calls.
addOn object (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 (WebAppConfig) } }
Fields
url string The URL for the web application.
entryPointConfig object (WebAppConfig) The entry point's configuration.

WebAppConfig

Web app entry point configuration.

JSON representation
{ "access": enum (Access), "executeAs": enum (ExecuteAs) }
Fields
access enum (Access) Who has permission to run the web app.
executeAs enum (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 (ExecutionApiConfig) } }
Fields
entryPointConfig object (ExecutionApiConfig) The entry point's configuration.

ExecutionApiConfig

API executable entry point configuration.

JSON representation
{ "access": enum (Access) }
Fields
access enum (Access) Who has permission to run the API executable.

AddOnEntryPoint

An add-on entry point.

JSON representation
{ "addOnType": enum (AddOnType), "title": string, "description": string, "helpUrl": string, "reportIssueUrl": string, "postInstallTipUrl": string }
Fields
addOnType enum (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
create Creates a deployment of an Apps Script project.
delete Deletes a deployment of an Apps Script project.
get Gets a deployment of an Apps Script project.
list Lists the deployments of an Apps Script project.
update Updates a deployment of an Apps Script project.