En esta página, se proporciona una descripción general del ejemplo de la app web de Apps Script para la API de Formularios de Google.
Requisitos previos
- Habilitar la API de Formularios en tu proyecto de Google Cloud
- Configura un nuevo proyecto de Apps Script como se describe en el archivo README de GitHub para la aplicación web de muestra.
Descripción general
La API de Formularios permite que cualquier cliente autenticado acceda a la API directamente con REST.
Debido a que Apps Script proporciona una forma sencilla de obtener un token de acceso de OAuth válido y de realizar llamadas REST, es sencillo integrar Apps Script directamente en la API de Formularios. Apps Script ya proporciona un servicio de Formularios existente, que permite que las secuencias de comandos creen Formularios de Google, accedan a ellos y los modifiquen. Sin embargo, si prefieres usar la API de Formularios directamente desde Apps Script, configura el acceso de OAuth de la siguiente manera:
Obtener un token de acceso de OAuth autenticado y con alcance
ScriptApp.getOAuthToken();Incluye el token de OAuth en el argumento options proporcionado en cualquier llamada de REST a la API.
UrlFetchApp.fetch(Url, options);
Consulta Cómo configurar un proyecto de Apps Script para ver un ejemplo de esto en acción. En la guía de configuración, se detallan los elementos básicos necesarios para llamar a la API. Sin embargo, para proporcionar un acceso intuitivo a la API para los usuarios finales, también puedes probar y modificar nuestra aplicación web de muestra.
Ejemplo de uso de la app web
Una app web de ejemplo completa que llama directamente a todos los métodos de la API de Formularios está disponible en GitHub para fines de demostración.
Ejecuta la app web
Una vez que hayas configurado tu proyecto y lo hayas implementado como una app web, puedes probar algunas operaciones básicas.
Para crear un formulario nuevo, haz clic en el botón Crear formulario.
El formulario nuevo ahora aparece en el campo ID del formulario: y puedes abrirlo haciendo clic en Abrir en Formularios.
Después de abrir el formulario nuevo en otra ventana, intenta agregar algunas preguntas manualmente. Luego, haz clic en Obtener formulario por ID para ver tus preguntas nuevas en el resultado de JSON a la derecha.
Puedes explorar los otros métodos disponibles en la app y observar el resultado de la derecha de cada operación.
Cómo trabajar con relojes de Formularios
Observa también los botones para relojes de formularios. Usan la función de observación de la API de Formularios y realizan operaciones básicas para crear, enumerar, borrar y renovar relojes. Debes configurar un proyecto con temas de Cloud Pub/Sub para usarlos.
Para obtener más información sobre los relojes de la API de Formularios y Cloud Pub/Sub, consulta Configura y recibe notificaciones push.
Próximos pasos
Intenta personalizar la app de ejemplo para adaptarla a tus necesidades. Estos son algunos ejemplos:
- Crea un banco de preguntas en una hoja de cálculo de Google y, luego, usa el servicio SpreadsheetApp de Apps Script para recuperar preguntas de una hoja de cálculo y propagar formularios nuevos.
- De forma alternativa, el banco de preguntas puede residir en una base de datos de SQL en la que puedes usar el servicio JDBC de Apps Script para propagar formularios con preguntas de la base de datos.
- Genera un cuestionario y guarda las puntuaciones en un libro de calificaciones de Hojas de cálculo de Google.
- Configura tu proyecto con Cloud Pub/Sub y usa la función watches a fin de generar una tabla de clasificación de estudiantes en tiempo real para mostrar los resultados del cuestionario.