En esta página, se proporciona una descripción general del ejemplo de app web de Apps Script para la API de Google Forms.
Requisitos previos
- Habilita la API de Forms en tu proyecto de Google Cloud.
- Configura un nuevo proyecto de Apps Script como se describe en el archivo README de GitHub para la app web de ejemplo.
Descripción general
La API de Formularios permite que cualquier cliente autenticado acceda a la API directamente con REST.
Dado que Apps Script proporciona una forma sencilla de obtener un token de acceso de OAuth válido y de realizar llamadas a REST, es sencillo integrar Apps Script directamente con la API de Formularios. Apps Script ya proporciona un servicio de Formularios existente, que permite que las secuencias de comandos creen, accedan y modifiquen Formularios de Google. Sin embargo, si prefieres usar la API de Forms directamente desde Apps Script, configura el acceso de OAuth de la siguiente manera:
Obtén un token de acceso de OAuth autenticado y con permiso.
ScriptApp.getOAuthToken();Incluye el token de OAuth en el argumento options que se proporciona en cualquier llamada REST a la API.
UrlFetchApp.fetch(Url, options);
Consulta Configura un proyecto de Apps Script para ver un ejemplo de esto en acción. En la guía de configuración, se detalla la canalización básica necesaria para llamar a la API. Sin embargo, para proporcionar acceso intuitivo a la API para los usuarios finales, también puedes probar y modificar nuestra app web de ejemplo.
Ejemplo de uso de la app web
Una app web de ejemplo completa que llama a todos los métodos de la API de Forms directamente está disponible en GitHub con fines demostrativos.
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 nuevo formulario ahora se puede ver en el campo ID del formulario: y puedes abrirlo haciendo clic en Abrir en Formularios.
Después de abrir el nuevo formulario en una ventana independiente, intenta agregar algunas preguntas manualmente y, luego, haz clic en Get Form by Id. Verás tus preguntas nuevas en el resultado JSON de la derecha.
No dudes en explorar los otros métodos disponibles en la app y observar el resultado a la derecha de cada operación.
Cómo trabajar con relojes de Formularios
Observa también los botones para los relojes de formularios. Estos usan la función de relojes de la API de Forms y realizan operaciones básicas para crear, enumerar, borrar y renovar relojes. Para usarlos, debes configurar un proyecto con temas de Cloud Pub/Sub.
Para obtener más información sobre los objetos de supervisión de la API de Forms y Cloud Pub/Sub, consulta Cómo configurar y recibir 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 y propagar formularios nuevos.
- Como alternativa, tu banco de preguntas puede residir en una base de datos de SQL en la que puedes usar el servicio de 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 para generar una tabla de clasificación de estudiantes en tiempo real que muestre los resultados de los cuestionarios.