La API de Apps Script (antes conocida como API de ejecución de Apps Script) te permite ejecutar de forma remota una función en un proyecto de secuencia de comandos al que tienes acceso. Tu app puede llamar a una función de Apps Script determinada, proporcionarle parámetros de entrada si es necesario y recibir una respuesta.
En los ejemplos de esta página, se muestra cómo se pueden lograr algunas operaciones de ejecución comunes con la API. Para obtener más información incluidos los requisitos de autorización especiales, consulta la guía Cómo ejecutar una función.
En estos ejemplos, se usan los marcadores de posición scriptId para indicar dónde proporcionarías el ID del proyecto de la secuencia de comandos. Sigue estos pasos para encontrar el ID de la secuencia de comandos:
- En el proyecto de Apps Script, en la parte superior izquierda, haz clic en Configuración del proyecto .
- Junto a "ID de la secuencia de comandos", haz clic en Copiar.
Ejecutar una función
La siguiente solicitud scripts.run llama a una función de Apps Script llamada listFolderContent y le pasa folderId de Drive y un número entero MAX_SIZE como argumentos. La función se ejecuta en modo de desarrollo, lo que significa que se ejecuta la versión más reciente guardada de la función, independientemente de la versión que se implemente como ejecutable.
A continuación, se muestra el protocolo de solicitud. En la guía Cómo ejecutar funciones, se muestra cómo implementar una solicitud de ejecución en diferentes lenguajes con las bibliotecas cliente de la API de Google.
POST https://script.googleapis.com/v1/scripts/scriptId :run
{
"function": "listFolderContent",
"parameters": [
folderId ,
MAX_SIZE
],
"devMode": true
}La respuesta a esta solicitud, una vez que se completa la función de Apps Script llamada, contiene los resultados de la ejecución o una respuesta de error. En este ejemplo, la función muestra correctamente un array de nombres de archivos:
{
"response": {
"result": [
"fileTitle1",
"fileTitle2",
"fileTitle3"
]
},
}Si la función encontró un error durante la ejecución de Apps Script, la respuesta podría verse de la siguiente manera:
{ "response": { "error": { "code": 3, "message": "ScriptError", "details": [{ "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError", "errorMessage": "The script enountered an exeception it could not resolve.", "errorType": "ScriptError", "scriptStackTraceElements": [{ "function": "listFolderContent", "lineNumber": 14 }] }] } } }