Regen all docs. (#700)
* Stop recursing if discovery == {}
* Generate docs with 'make docs'.
diff --git a/docs/dyn/script_v1.scripts.html b/docs/dyn/script_v1.scripts.html
index abaadb0..6505951 100644
--- a/docs/dyn/script_v1.scripts.html
+++ b/docs/dyn/script_v1.scripts.html
@@ -72,16 +72,17 @@
</style>
-<h1><a href="script_v1.html">Google Apps Script Execution API</a> . <a href="script_v1.scripts.html">scripts</a></h1>
+<h1><a href="script_v1.html">Apps Script API</a> . <a href="script_v1.scripts.html">scripts</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#run">run(scriptId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Runs a function in an Apps Script project. The project must be deployed</p>
+<p class="firstline">Runs a function in an Apps Script project. The script project must be</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="run">run(scriptId, body, x__xgafv=None)</code>
- <pre>Runs a function in an Apps Script project. The project must be deployed
-for use with the Apps Script Execution API.
+ <pre>Runs a function in an Apps Script project. The script project must be
+deployed for use with the Apps Script API and the calling application must
+share the same Cloud Platform project.
This method requires authorization with an OAuth 2.0 token that includes at
least one of the scopes listed in the [Authorization](#authorization)
@@ -90,8 +91,12 @@
authentication token, open the project in the script editor, then select
**File > Project properties** and click the **Scopes** tab.
+The error `403, PERMISSION_DENIED: The caller does not have permission`
+indicates that the Cloud Platform project used to authorize the request is
+not the same as the one used by the script.
+
Args:
- scriptId: string, The project key of the script to be executed. To find the project key, open
+ scriptId: string, The script ID of the script to be executed. To find the script ID, open
the project in the script editor and select **File > Project properties**. (required)
body: object, The request body. (required)
The object takes the form of:
@@ -100,10 +105,11 @@
# specified `script_id`. Executing a function on a script returns results
# based on the implementation of the script.
"function": "A String", # The name of the function to execute in the given script. The name does not
- # include parentheses or parameters.
+ # include parentheses or parameters. It can reference a function in an
+ # included library such as `Library.libFunction1`.
"devMode": True or False, # 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 Execution API. Optional; default is `false`.
+ # the Apps Script API. Optional; default is `false`.
"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
@@ -111,14 +117,16 @@
# `string`, `number`, `array`, `object`, or `boolean`. Optional.
"",
],
- "sessionState": "A String", # For 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)
+ "sessionState": "A String", # <b>Deprecated</b>. 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
+ # [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.
}
@@ -131,27 +139,38 @@
Returns:
An object of the form:
- { # The response will not arrive until the function finishes executing. The maximum runtime is listed in the guide to [limitations in Apps Script](https://developers.google.com/apps-script/guides/services/quotas#current_limitations).
- # <p>If the script function returns successfully, the `response` field will contain an `ExecutionResponse` object with the function's return value in the object's `result` field.</p>
- # <p>If the script function (or Apps Script itself) throws an exception, the `error` field will contain a `Status` object. The `Status` object's `details` field will contain an array with a single `ExecutionError` object that provides information about the nature of the error.</p>
- # <p>If the `run` call itself fails (for example, because of a malformed request or an authorization error), the method will return an HTTP response code in the 4XX range with a different format for the response body. Client libraries will automatically convert a 4XX response into an exception class.</p>
- "metadata": { # This field is not used.
+ { # A representation of an execution of an Apps Script function started with run. The execution response does not arrive until the function finishes executing. The maximum execution runtime is listed in the [Apps Script quotas guide](/apps-script/guides/services/quotas#current_limitations). <p>After execution has started, it can have one of four outcomes:</p> <ul> <li> If the script function returns successfully, the
+ # response field contains an
+ # ExecutionResponse object
+ # with the function's return value in the object's `result` field.</li>
+ # <li> If the script function (or Apps Script itself) throws an exception, the
+ # error field contains a
+ # Status object. The `Status` object's `details`
+ # field contains an array with a single
+ # ExecutionError object that
+ # provides information about the nature of the error.</li>
+ # <li> If the execution has not yet completed,
+ # the done field is `false` and
+ # the neither the `response` nor `error` fields are present.</li>
+ # <li> If the `run` call itself fails (for example, because of a
+ # malformed request or an authorization error), the method returns an HTTP
+ # response code in the 4XX range with a different format for the response
+ # body. Client libraries automatically convert a 4XX response into an
+ # exception class.</li>
+ # </ul>
+ "done": True or False, # This field indicates whether the script execution has completed. A completed execution has a populated `response` field containing the ExecutionResponse from function that was executed.
+ "response": { # If the script function returns successfully, this field contains an ExecutionResponse object with the function's return value.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
- "error": { # If a `run` call succeeds but the script function (or Apps Script itself) throws an exception, the response body's `error` field will contain this `Status` object. # If a `run` call succeeds but the script function (or Apps Script itself) throws an exception, this field will contain a `Status` object. The `Status` object's `details` field will contain an array with a single `ExecutionError` object that provides information about the nature of the error.
- "message": "A String", # A developer-facing error message, which is in English. Any user-facing error message is localized and sent in the [`google.rpc.Status.details`](google.rpc.Status.details) field, or localized by the client.
- "code": 42, # The status code. For this API, this value will always be 3, corresponding to an INVALID_ARGUMENT error.
- "details": [ # An array that contains a single `ExecutionError` object that provides information about the nature of the error.
+ "error": { # If a `run` call succeeds but the script function (or Apps Script itself) throws an exception, the response body's error field contains this `Status` object. # If a `run` call succeeds but the script function (or Apps Script itself) throws an exception, this field contains a Status object. The `Status` object's `details` field contains an array with a single ExecutionError object that provides information about the nature of the error.
+ "message": "A String", # A developer-facing error message, which is in English. Any user-facing error message is localized and sent in the details field, or localized by the client.
+ "code": 42, # The status code. For this API, this value either: <ul> <li> 10, indicating a `SCRIPT_TIMEOUT` error,</li> <li> 3, indicating an `INVALID_ARGUMENT` error, or</li> <li> 1, indicating a `CANCELLED` execution.</li> </ul>
+ "details": [ # An array that contains a single ExecutionError object that provides information about the nature of the error.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
},
- "done": True or False, # This field is not used.
- "response": { # If the script function returns successfully, this field will contain an `ExecutionResponse` object with the function's return value as the object's `result` field.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "name": "A String", # This field is not used.
}</pre>
</div>