Apps web

Si compilas una interfaz de usuario para una secuencia de comandos, puedes publicarla como aplicación web. Por ejemplo, una secuencia de comandos que permita a los usuarios programar citas con los miembros de un equipo de asistencia se presentarían mejor como una aplicación web para que los usuarios pueden acceder a él directamente desde sus navegadores.

Tanto las secuencias de comandos independientes como secuencias de comandos vinculadas a Google Workspace aplicaciones puede convertirse en aplicaciones web, siempre que cumplan con los requisitos que se mencionan a continuación.

Requisitos para apps web

Una secuencia de comandos se puede publicar como una aplicación web si cumple con estos requisitos:

• Contiene una función doGet(e) o doPost(e).
• La función muestra un servicio HTML HtmlOutput o un Servicio de contenido TextOutput.

parámetros de solicitud

Cuando un usuario visita una app, o un programa envía a esta una solicitud GET HTTP, Apps Script ejecuta la función doGet(e). Cuando un programa envía a la app una solicitud HTTP POST, Apps Script ejecuta doPost(e) en su lugar. En ambos casos, e representa un parámetro de evento que puede contener información sobre cualquier los parámetros de solicitud. La estructura del objeto de evento se muestra en la tabla. a continuación:

Campos
e.queryString	El valor de la parte de la cadena de consulta de la URL, o null si no se especifica una cadena de consulta name=alice&n=1&n=2
e.parameter	Un objeto de pares clave-valor que corresponden a los parámetros de solicitud. Solo se muestra el primer valor para los parámetros que tienen varios valores. {"name": "alice", "n": "1"}
e.parameters	Un objeto similar a e.parameter, pero con un array de valores para cada clave {"name": ["alice"], "n": ["1", "2"]}
e.pathInfo	La ruta de URL después de /exec o /dev. Por ejemplo, si la ruta de URL termina en /exec/hello, el la información de la ruta de acceso es hello.
e.contextPath	No se usa. Siempre se trata de la cadena vacía.
e.contentLength	La longitud del cuerpo de la solicitud para las solicitudes POST o -1 para las solicitudes GET 332
e.postData.length	Es igual a e.contentLength 332
e.postData.type	El tipo de MIME del cuerpo de POST text/csv
e.postData.contents	El texto del contenido del cuerpo de POST Alice,21
e.postData.name	Siempre debe tener el valor "postData". postData

Por ejemplo, puedes pasar parámetros como username y age. a una URL, como se muestra a continuación:

https://script.google.com/.../exec?username=jsmith&age=21

Luego, puedes mostrar los parámetros de la siguiente manera:

function doGet(e) {
  var params = JSON.stringify(e);
  return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}

En el ejemplo anterior, doGet(e) muestra el siguiente resultado:

{
  "queryString": "username=jsmith&age=21",
  "parameter": {
    "username": "jsmith",
    "age": "21"
  },
  "contextPath": "",
  "parameters": {
    "username": [
      "jsmith"
    ],
    "age": [
      "21"
    ]
  },
  "contentLength": -1
}

Advertencia: El sistema reserva los siguientes nombres de parámetros y no deben Utilizar en parámetros de URL o cuerpos de POST:

• c
• sid

El uso de estos parámetros puede dar como resultado una respuesta HTTP 405 con el mensaje de error. "El archivo que solicitaste no existe". Si es posible, actualiza tu para usar diferentes nombres de parámetros.

Implementa una secuencia de comandos como una app web

Para implementar una secuencia de comandos como una aplicación web, sigue estos pasos:

1. En la esquina superior derecha del proyecto de secuencia de comandos, haz clic en Implementar > Implementación nueva.
2. Junto a "Seleccionar tipo", haz clic en Habilitar tipos de implementaciones Aplicación web.
3. Ingresa la información sobre tu app web en los campos de “Implementación” configuración”.
4. Haz clic en Implementar.

Puedes compartir la URL de la app web con aquellas personas que quieres que usen tu app, siempre y cuando les otorgues acceso.

Nota: Las apps web implementadas en un dominio dejan de funcionar si su propiedad cambios en una unidad compartida o una cuenta diferente en otro dominio. Para corregir este error, haz que la El propietario o colaborador nuevo volverá a implementar la app web en el dominio nuevo. Por otro lado, Si la aplicación web vuelve a su dominio original, comenzará que vuelva a funcionar para ese dominio sin volver a implementarlo.

Prueba una implementación de app web

Para probar tu secuencia de comandos como una aplicación web, sigue estos pasos:

1. En la esquina superior derecha del proyecto de secuencia de comandos, haz clic en Implementar > Realiza pruebas Deployment.
2. Junto a "Seleccionar tipo", haz clic en Habilitar tipos de implementaciones > Aplicación web.
3. Debajo de la URL de la app web, haz clic en Copiar.

4. Pega la URL en tu navegador y prueba tu app web.

   Esta URL termina en /dev, y solo los usuarios con acceso de edición pueden acceder a ella al guion. Esta instancia de la app siempre ejecuta la última vez que se guardó código y está diseñado únicamente para realizar pruebas durante el desarrollo.

Advertencia: Cuando implementes aplicaciones web para que se ejecuten como desarrollador, debes Ten mucho cuidado cuando manejes tokens de OAuth que se obtuvieron mediante ScriptApp.getOAuthToken(). Estos tokens pueden permitir que otras aplicaciones accedan a tus datos, nunca transmitirlas al cliente.

Permisos

Los permisos de una app web difieren según cómo elijas ejecutarla la aplicación:

• Ejecutar la app como yo: En este caso, la secuencia de comandos siempre se ejecuta. como tú, el propietario de la secuencia de comandos, sin importar quién acceda a la aplicación web.
• Ejecuta la app como un usuario que accede a la app web: en este caso, la secuencia de comandos se ejecuta con la identidad del usuario activo que usa la app web. Este permiso enfoque hace que la aplicación web muestre el correo electrónico del propietario de la secuencia de comandos cuando el usuario autoriza el acceso.

Advertencia: Para evitar abusos, Apps Script impone límites en la frecuencia en el que los usuarios nuevos pueden autorizar una app web que se ejecuta como el usuario. Estos límites dependen, entre otros factores, de si la cuenta de publicación forma parte del un dominio Google Workspace.

Nota: Puedes colaborar en apps web usando unidad compartida. Cuando se implementa una app web en una versión compartida, elige “ejecutar como tú” causas que la app web se ejecute bajo la autoridad del usuario que la implementó (ya que no hay un propietario de secuencia de comandos).

Incorpore su aplicación web en Google Sites

Advertencia: Las apps web incorporadas aún están sujetas a permisos de acceso para evitar o para un uso malicioso. Si la app web incorporada no funciona, revisa si hay algún problema. si los permisos establecidos por el propietario de la aplicación web y el administrador del dominio otorgan su uso.

Para incorporar una app web en Google Sites, primero se debe implementado. También necesitas la URL implementada del diálogo Deploy.

Para incorporar una aplicación web a Sites, haz lo siguiente: sigue estos pasos:

1. Abre la página Sitios en la que deseas agregar la aplicación web.
2. Selecciona Insertar > Incorporar URL
3. Pega la URL de la aplicación web y, luego, haz clic en AGREGAR.

La aplicación web aparece en un marco en la vista previa de la página. Cuándo publicas la página, es posible que los visitantes de tu sitio deban autorizar la aplicación web antes de que se ejecuta normalmente. Las aplicaciones web no autorizadas presentan solicitudes de autorización a del usuario.

Historial del navegador y aplicaciones web

Puede ser conveniente que una aplicación web de Apps Script simule una secuencia de comandos o una con una IU dinámica controlada por medio de parámetros de URL. Para hacerlo bien, puedes definir un objeto de estado que represente el comportamiento IU o página y envía el estado al historial de navegación como el usuario navega por tu aplicación. También puedes escuchar los eventos del historial para que tu app muestra la IU correcta cuando el usuario navega hacia adelante y hacia atrás con el en los botones del navegador. Si consultas los parámetros de URL en el momento de la carga, podrás tener La app compila su IU de forma dinámica en función de esos parámetros, lo que le permite al usuario iniciar la aplicación en un estado particular.

Apps Script proporciona dos APIs de JavaScript del lado del cliente asíncronas para brindar asistencia para crear aplicaciones web vinculadas al historial de navegación:

• google.script.history proporciona métodos para permitir una respuesta dinámica a los cambios del historial del navegador. Esta incluye: enviar estados (objetos simples que puedes definir) al navegador del historial, reemplazar el estado superior en la pila del historial y configurar un objeto de escucha para responder a los cambios del historial.

• google.script.url proporciona el medio para recuperar los parámetros y el fragmento de URL de la página actual, si cuando están presentes.

Estas APIs de historial solo están disponibles para las apps web. No son compatible con barras laterales, diálogos o complementos. Esta funcionalidad también es no se recomienda su uso en aplicaciones web incorporadas en Google Sites.