Api-roll 45: 2017-02-13

discovery/googleapis/script__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
-                "https://mail.google.com/": {
-                    "description": "View and manage your mail"
+                "https://www.googleapis.com/auth/userinfo.email": {
+                    "description": "View your email address"
                 },
                 "https://www.google.com/calendar/feeds": {
                     "description": "Manage your calendars"
                 },
-                "https://www.google.com/m8/feeds": {
-                    "description": "Manage your contacts"
+                "https://www.googleapis.com/auth/groups": {
+                    "description": "View and manage your Google Groups"
+                },
+                "https://www.googleapis.com/auth/forms.currentonly": {
+                    "description": "View and manage forms that this application has been installed in"
+                },
+                "https://www.googleapis.com/auth/drive": {
+                    "description": "View and manage the files in your Google Drive"
+                },
+                "https://www.googleapis.com/auth/admin.directory.user": {
+                    "description": "View and manage the provisioning of users on your domain"
                 },
                 "https://www.googleapis.com/auth/admin.directory.group": {
                     "description": "View and manage the provisioning of groups on your domain"
                 },
-                "https://www.googleapis.com/auth/admin.directory.user": {
-                    "description": "View and manage the provisioning of users on your domain"
+                "https://www.googleapis.com/auth/spreadsheets": {
+                    "description": "View and manage your spreadsheets in Google Drive"
                 },
-                "https://www.googleapis.com/auth/drive": {
-                    "description": "View and manage the files in your Google Drive"
+                "https://mail.google.com/": {
+                    "description": "View and manage your mail"
                 },
                 "https://www.googleapis.com/auth/forms": {
                     "description": "View and manage your forms in Google Drive"
                 },
-                "https://www.googleapis.com/auth/forms.currentonly": {
-                    "description": "View and manage forms that this application has been installed in"
-                },
-                "https://www.googleapis.com/auth/groups": {
-                    "description": "View and manage your Google Groups"
-                },
-                "https://www.googleapis.com/auth/spreadsheets": {
-                    "description": "View and manage your spreadsheets in Google Drive"
-                },
-                "https://www.googleapis.com/auth/userinfo.email": {
-                    "description": "View your email address"
+                "https://www.google.com/m8/feeds": {
+                    "description": "Manage your contacts"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://script.googleapis.com/",
     "batchPath": "batch",
     "description": "Executes Google Apps Script projects.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/apps-script/execution/rest/v1/scripts/run",
-    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/FcNWZezE05ypidUunx03uCyJR70\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "script:v1",
     "kind": "discovery#restDescription",
     "name": "script",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
-        "access_token": {
-            "description": "OAuth access token.",
+        "fields": {
+            "description": "Selector specifying which fields to include in a partial response.",
             "location": "query",
             "type": "string"
         },
-        "alt": {
-            "default": "json",
-            "description": "Data format for response.",
+        "uploadType": {
+            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+            "location": "query",
+            "type": "string"
+        },
+        "$.xgafv": {
+            "description": "V1 error format.",
+            "enum": [
+                "1",
+                "2"
+            ],
             "enumDescriptions": [
-                "Responses with Content-Type of application/json",
-                "Media download with context-dependent Content-Type",
-                "Responses with Content-Type of application/x-protobuf"
+                "v1 error format",
+                "v2 error format"
             ],
             "location": "query",
             "type": "string"
         },
-        "bearer_token": {
-            "description": "OAuth bearer token.",
-            "location": "query",
-            "type": "string"
-        },
         "callback": {
             "description": "JSONP",
             "location": "query",
             "type": "string"
         },
-        "fields": {
-            "description": "Selector specifying which fields to include in a partial response.",
+        "alt": {
+            "default": "json",
+            "description": "Data format for response.",
+            "enum": [
+                "json",
+                "media",
+                "proto"
+            ],
+            "enumDescriptions": [
+                "Responses with Content-Type of application/json",
+                "Media download with context-dependent Content-Type",
+                "Responses with Content-Type of application/x-protobuf"
+            ],
             "location": "query",
             "type": "string"
         },
+        "access_token": {
+            "description": "OAuth access token.",
+            "location": "query",
+            "type": "string"
+        },
         "key": {
             "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
             "location": "query",
             "type": "string"
         },
-        "oauth_token": {
-            "description": "OAuth 2.0 token for the current user.",
+        "quotaUser": {
+            "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
             "location": "query",
             "type": "string"
         },
         "pp": {
             "default": "true",
             "description": "Pretty-print response.",
             "location": "query",
             "type": "boolean"
         },
-        "prettyPrint": {
-            "default": "true",
-            "description": "Returns response with indentations and line breaks.",
-            "location": "query",
-            "type": "boolean"
-        },
-        "quotaUser": {
-            "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+        "oauth_token": {
+            "description": "OAuth 2.0 token for the current user.",
             "location": "query",
             "type": "string"
         },
+        "bearer_token": {
+            "description": "OAuth bearer token.",
+            "location": "query",
+            "type": "string"
+        },
         "upload_protocol": {
             "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
             "location": "query",
             "type": "string"
         },
-        "uploadType": {
-            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+        "prettyPrint": {
+            "default": "true",
+            "description": "Returns response with indentations and line breaks.",
             "location": "query",
-            "type": "string"
-        },
-        "$.xgafv": {
-            "description": "V1 error format.",
-            "enumDescriptions": [
-                "v1 error format",
-                "v2 error format"
-            ],
-            "location": "query",
-            "type": "string"
+            "type": "boolean"
         }
     },
     "protocol": "rest",
     "resources": {
         "scripts": {
             "methods": {
                 "run": {
-                    "description": "Runs a function in an Apps Script project that has been deployed for use with the Apps Script Execution API. This method requires authorization with an OAuth 2.0 token that includes at least one of the scopes listed in the [Authentication](#authentication) section; script projects that do not require authorization cannot be executed through this API. To find the correct scopes to include in the authentication token, open the project in the script editor, then select **File > Project properties** and click the **Scopes** tab.",
+                    "description": "Runs a function in an Apps Script project. The project must be deployed\nfor use with the Apps Script Execution API.\n\nThis method requires authorization with an OAuth 2.0 token that includes at\nleast one of the scopes listed in the [Authorization](#authorization)\nsection; script projects that do not require authorization cannot be\nexecuted through this API. To find the correct scopes to include in the\nauthentication token, open the project in the script editor, then select\n**File > Project properties** and click the **Scopes** tab.",
                     "httpMethod": "POST",
                     "id": "script.scripts.run",
                     "parameterOrder": [
                         "scriptId"
                     ],
                     "parameters": {
                         "scriptId": {
-                            "description": "The project key of the script to be executed. To find the project key, open the project in the script editor, then select **File > Project properties**.",
+                            "description": "The project key of the script to be executed. To find the project key, open\nthe project in the script editor and select **File > Project properties**.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/scripts/{scriptId}:run",
                     "request": {
                         "$ref": "ExecutionRequest"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://mail.google.com/",
                         "https://www.google.com/calendar/feeds",
                         "https://www.google.com/m8/feeds",
                         "https://www.googleapis.com/auth/admin.directory.group",
                         "https://www.googleapis.com/auth/admin.directory.user",
                         "https://www.googleapis.com/auth/drive",
                         "https://www.googleapis.com/auth/forms",
                         "https://www.googleapis.com/auth/forms.currentonly",
                         "https://www.googleapis.com/auth/groups",
                         "https://www.googleapis.com/auth/spreadsheets",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 }
             }
         }
     },
-    "revision": "20160801",
+    "revision": "20170209",
     "rootUrl": "https://script.googleapis.com/",
     "schemas": {
-        "ExecutionRequest": {
-            "description": "A request to run the function in a script. The script is identified by the specified `script_id`. Executing a function on a script will return results based on the implementation of the script.",
-            "id": "ExecutionRequest",
+        "ExecutionResponse": {
+            "description": "An object that provides the return value of a function executed through the\nApps Script Execution API. If a\n`run` call succeeds and the\nscript function returns successfully, the response body's\n`response` field contains this\n`ExecutionResponse` object.",
+            "id": "ExecutionResponse",
             "properties": {
-                "function": {
-                    "description": "The name of the function to execute in the given script. The name does not include parentheses or parameters.",
-                    "type": "string"
-                },
-                "parameters": {
-                    "description": "The parameters to be passed to the function being executed. The type for each parameter should match the expected type in Apps Script. Parameters cannot be Apps Script-specific objects (such as a `Document` or `Calendar`); they can only be primitive types such as a `string`, `number`, `array`, `object`, or `boolean`. Optional.",
-                    "items": {
-                        "type": "any"
-                    },
-                    "type": "array"
-                },
-                "sessionState": {
-                    "description": "This field is not used.",
-                    "type": "string"
-                },
-                "devMode": {
-                    "description": "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`.",
-                    "type": "boolean"
+                "result": {
+                    "description": "The return value of the script function. The type matches the object type\nreturned in Apps Script. Functions called through the Execution API cannot\nreturn Apps Script-specific objects (such as a `Document` or a `Calendar`);\nthey can only return primitive types such as a `string`, `number`, `array`,\n`object`, or `boolean`.",
+                    "type": "any"
                 }
             },
             "type": "object"
         },
         "Operation": {
-            "description": "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).\nIf 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.\n\nIf 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.\n\nIf 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.",
+            "description": "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).\n<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>\n<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>\n<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>",
             "id": "Operation",
             "properties": {
+                "response": {
+                    "additionalProperties": {
+                        "description": "Properties of the object. Contains field @type with type URL.",
+                        "type": "any"
+                    },
+                    "description": "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.",
+                    "type": "object"
+                },
                 "name": {
                     "description": "This field is not used.",
                     "type": "string"
                 },
+                "error": {
+                    "$ref": "Status",
+                    "description": "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."
+                },
                 "metadata": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "This field is not used.",
                     "type": "object"
                 },
                 "done": {
                     "description": "This field is not used.",
                     "type": "boolean"
-                },
-                "error": {
-                    "$ref": "Status",
-                    "description": "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."
-                },
-                "response": {
-                    "additionalProperties": {
-                        "description": "Properties of the object. Contains field @type with type URL.",
-                        "type": "any"
-                    },
-                    "description": "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.",
-                    "type": "object"
-                }
-            },
-            "type": "object"
-        },
-        "Status": {
-            "description": "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.",
-            "id": "Status",
-            "properties": {
-                "code": {
-                    "description": "The status code, which should be an enum value of google.rpc.Code.",
-                    "format": "int32",
-                    "type": "integer"
-                },
-                "message": {
-                    "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.",
-                    "type": "string"
-                },
-                "details": {
-                    "description": "An array that contains a single `ExecutionError` object that provides information about the nature of the error.",
-                    "items": {
-                        "additionalProperties": {
-                            "description": "Properties of the object. Contains field @type with type URL.",
-                            "type": "any"
-                        },
-                        "type": "object"
-                    },
-                    "type": "array"
-                }
-            },
-            "type": "object"
-        },
-        "ExecutionError": {
-            "description": "An object that provides information about the nature of an error in the Apps Script Execution API. If an `run` call succeeds but the script function (or Apps Script itself) throws an exception, the response body's `error` field will contain a `Status` object. The `Status` object's `details` field will contain an array with a single one of these `ExecutionError` objects.",
-            "id": "ExecutionError",
-            "properties": {
-                "scriptStackTraceElements": {
-                    "description": "An array of objects that provide a stack trace through the script to show where the execution failed, with the deepest call first.",
-                    "items": {
-                        "$ref": "ScriptStackTraceElement"
-                    },
-                    "type": "array"
-                },
-                "errorMessage": {
-                    "description": "The error message thrown by Apps Script, usually localized into the user's language.",
-                    "type": "string"
-                },
-                "errorType": {
-                    "description": "The error type, for example `TypeError` or `ReferenceError`. If the error type is unavailable, this field is not included.",
-                    "type": "string"
                 }
             },
             "type": "object"
         },
         "ScriptStackTraceElement": {
             "description": "A stack trace through the script that shows where the execution failed.",
             "id": "ScriptStackTraceElement",
             "properties": {
                 "function": {
                     "description": "The name of the function that failed.",
                     "type": "string"
                 },
                 "lineNumber": {
                     "description": "The line number where the script failed.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
-        "ExecutionResponse": {
-            "description": "An object that provides the return value of a function executed through the Apps Script Execution API. If an `run` call succeeds and the script function returns successfully, the response body's `response` field will contain this `ExecutionResponse` object.",
-            "id": "ExecutionResponse",
+        "ExecutionError": {
+            "description": "An object that provides information about the nature of an error in the Apps\nScript Execution API. If an\n`run` call succeeds but the\nscript function (or Apps Script itself) throws an exception, the response\nbody's `error` field contains a\n`Status` object. The `Status` object's `details` field\ncontains an array with a single one of these `ExecutionError` objects.",
+            "id": "ExecutionError",
             "properties": {
-                "result": {
-                    "description": "The return value of the script function. The type will match the type returned in Apps Script. Functions called through the Execution API cannot return Apps Script-specific objects (such as a `Document` or `Calendar`); they can only return primitive types such as a `string`, `number`, `array`, `object`, or `boolean`.",
-                    "type": "any"
+                "errorType": {
+                    "description": "The error type, for example `TypeError` or `ReferenceError`. If the error\ntype is unavailable, this field is not included.",
+                    "type": "string"
                 },
-                "status": {
-                    "enum": [
-                        "SUCCESS",
-                        "CANCELED"
-                    ],
+                "errorMessage": {
+                    "description": "The error message thrown by Apps Script, usually localized into the user's\nlanguage.",
+                    "type": "string"
+                },
+                "scriptStackTraceElements": {
+                    "description": "An array of objects that provide a stack trace through the script to show\nwhere the execution failed, with the deepest call first.",
+                    "items": {
+                        "$ref": "ScriptStackTraceElement"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "Status": {
+            "description": "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.",
+            "id": "Status",
+            "properties": {
+                "details": {
+                    "description": "An array that contains a single `ExecutionError` object that provides information about the nature of the error.",
+                    "items": {
+                        "additionalProperties": {
+                            "description": "Properties of the object. Contains field @type with type URL.",
+                            "type": "any"
+                        },
+                        "type": "object"
+                    },
+                    "type": "array"
+                },
+                "code": {
+                    "description": "The status code. For this API, this value will always be 3, corresponding to an INVALID_ARGUMENT error.",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "message": {
+                    "description": "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.",
                     "type": "string"
                 }
             },
+            "type": "object"
+        },
+        "ExecutionRequest": {
+            "description": "A request to run the function in a script. The script is identified by the\nspecified `script_id`. Executing a function on a script returns results\nbased on the implementation of the script.",
+            "id": "ExecutionRequest",
+            "properties": {
+                "function": {
+                    "description": "The name of the function to execute in the given script. The name does not\ninclude parentheses or parameters.",
+                    "type": "string"
+                },
+                "devMode": {
+                    "description": "If `true` and the user is an owner of the script, the script runs at the\nmost recently saved version rather than the version deployed for use with\nthe Execution API. Optional; default is `false`.",
+                    "type": "boolean"
+                },
+                "parameters": {
+                    "description": "The parameters to be passed to the function being executed. The object type\nfor each parameter should match the expected type in Apps Script.\nParameters cannot be Apps Script-specific object types (such as a\n`Document` or a `Calendar`); they can only be primitive types such as\n`string`, `number`, `array`, `object`, or `boolean`. Optional.",
+                    "items": {
+                        "type": "any"
+                    },
+                    "type": "array"
+                },
+                "sessionState": {
+                    "description": "For Android add-ons only. An ID that represents the user's current session\nin the Android app for Google Docs or Sheets, included as extra data in the\n[`Intent`](https://developer.android.com/guide/components/intents-filters.html)\nthat launches the add-on. When an Android add-on is run with a session\nstate, it gains the privileges of a\n[bound](https://developers.google.com/apps-script/guides/bound) script &mdash;\nthat is, it can access information like the user's current cursor position\n(in Docs) or selected cell (in Sheets). To retrieve the state, call\n`Intent.getStringExtra(\"com.google.android.apps.docs.addons.SessionState\")`.\nOptional.",
+                    "type": "string"
+                }
+            },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Apps Script Execution API",
     "version": "v1"
 }