com.google.api.services.script.model

Class ExecutionRequest

java.lang.Object

java.util.AbstractMap<String,Object>

com.google.api.client.util.GenericData

com.google.api.client.json.GenericJson

com.google.api.services.script.model.ExecutionRequest

All Implemented Interfaces:

Cloneable, Map<String,Object>

public final class ExecutionRequest
extends com.google.api.client.json.GenericJson

A request to run the function in a script. The script is identified by the specified `script_id`. Executing a function on a script returns results based on the implementation of the script.

This is the Java data model class that specifies how to parse/serialize into the JSON that is transmitted over HTTP when working with the Apps Script API. For a detailed explanation see: https://developers.google.com/api-client-library/java/google-http-java-client/json

Author:

Google, Inc.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

com.google.api.client.util.GenericData.Flags

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
ExecutionRequest()

Method Summary

Modifier and Type	Method and Description
ExecutionRequest	clone()
Boolean	getDevMode() If `true` and the user is an owner of the script, the script runs at the most recently saved version rather than the version deployed for use with the Apps Script API.
String	getFunction() The name of the function to execute in the given script.
List<Object>	getParameters() The parameters to be passed to the function being executed.
String	getSessionState() *Deprecated*.
ExecutionRequest	set(String fieldName, Object value)
ExecutionRequest	setDevMode(Boolean devMode) If `true` and the user is an owner of the script, the script runs at the most recently saved version rather than the version deployed for use with the Apps Script API.
ExecutionRequest	setFunction(String function) The name of the function to execute in the given script.
ExecutionRequest	setParameters(List<Object> parameters) The parameters to be passed to the function being executed.
ExecutionRequest	setSessionState(String sessionState) *Deprecated*.

Methods inherited from class com.google.api.client.json.GenericJson

getFactory, setFactory, toPrettyString, toString

Methods inherited from class com.google.api.client.util.GenericData

entrySet, equals, get, getClassInfo, getUnknownKeys, hashCode, put, putAll, remove, setUnknownKeys

Methods inherited from class java.util.AbstractMap

clear, containsKey, containsValue, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

ExecutionRequest

public ExecutionRequest()

Method Detail

getDevMode

public Boolean getDevMode()

If `true` and the user is an owner of the script, the script runs at the most recently saved version rather than the version deployed for use with the Apps Script API. Optional; default is `false`.

Returns:

value or null for none

setDevMode

public ExecutionRequest setDevMode(Boolean devMode)

If `true` and the user is an owner of the script, the script runs at the most recently saved version rather than the version deployed for use with the Apps Script API. Optional; default is `false`.

Parameters:

devMode - devMode or null for none

getFunction

public String getFunction()

The name of the function to execute in the given script. The name does not include parentheses or parameters. It can reference a function in an included library such as `Library.libFunction1`.

Returns:

value or null for none

setFunction

public ExecutionRequest setFunction(String function)

The name of the function to execute in the given script. The name does not include parentheses or parameters. It can reference a function in an included library such as `Library.libFunction1`.

Parameters:

function - function or null for none

getParameters

public List<Object> getParameters()

The parameters to be passed to the function being executed. The object type for each parameter should match the expected type in Apps Script. Parameters cannot be Apps Script-specific object types (such as a `Document` or a `Calendar`); they can only be primitive types such as `string`, `number`, `array`, `object`, or `boolean`. Optional.

Returns:

value or null for none

setParameters

public ExecutionRequest setParameters(List<Object> parameters)

The parameters to be passed to the function being executed. The object type for each parameter should match the expected type in Apps Script. Parameters cannot be Apps Script-specific object types (such as a `Document` or a `Calendar`); they can only be primitive types such as `string`, `number`, `array`, `object`, or `boolean`. Optional.

Parameters:

parameters - parameters or null for none

getSessionState

public String getSessionState()

*Deprecated*. For use with Android add-ons only. An ID that represents the user's current session in the Android app for Google Docs or Sheets, included as extra data in the [Intent](https://developer.android.com/guide/components/intents-filters.html) that launches the add-on. When an Android add-on is run with a session state, it gains the privileges of a [bound](https://developers.google.com/apps-script/guides/bound) script—that is, it can access information like the user's current cursor position (in Docs) or selected cell (in Sheets). To retrieve the state, call `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionState")`. Optional.

Returns:

value or null for none

setSessionState

public ExecutionRequest setSessionState(String sessionState)

*Deprecated*. For use with Android add-ons only. An ID that represents the user's current session in the Android app for Google Docs or Sheets, included as extra data in the [Intent](https://developer.android.com/guide/components/intents-filters.html) that launches the add-on. When an Android add-on is run with a session state, it gains the privileges of a [bound](https://developers.google.com/apps-script/guides/bound) script—that is, it can access information like the user's current cursor position (in Docs) or selected cell (in Sheets). To retrieve the state, call `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionState")`. Optional.

Parameters:

sessionState - sessionState or null for none

set

public ExecutionRequest set(String fieldName,
                            Object value)

Overrides:

set in class com.google.api.client.json.GenericJson

clone

public ExecutionRequest clone()

Overrides:

clone in class com.google.api.client.json.GenericJson