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
- 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 Forms permite que cualquier cliente autenticado acceda a la API directamente con REST.
Dado que Apps Script proporciona una forma de obtener un token de acceso de OAuth válido y realizar llamadas a REST, es posible integrar Apps Script directamente con la API de Forms. Apps Script ya proporciona un servicio de Forms existente, que permite que las secuencias de comandos creen, accedan y modifiquen formularios. Sin embargo, si prefieres usar la API de Forms directamente desde Apps Script, configura el acceso a OAuth de la siguiente manera:
Obtén un token de acceso de OAuth autenticado y con alcance.
ScriptApp.getOAuthToken();Incluye el token de OAuth en el argumento options que se proporciona en cualquier llamada a la API de REST.
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 detalla la infraestructura necesaria para llamar a la API. Sin embargo, para proporcionar a los usuarios un acceso intuitivo a la API, también puedes probar y modificar nuestra app web de ejemplo.
Ejemplo de uso de la app web
En el repositorio de GitHub apps-script-samples, se encuentra disponible una app web de ejemplo completa que llama a todos los métodos de la API de Forms directamente.
Ejecuta la app web
Una vez que hayas configurado tu proyecto y lo hayas implementado como una app web, puedes probar algunas operaciones.
Haz clic en el botón Crear formulario para crear uno nuevo.
El formulario nuevo ahora se puede ver en el campo ID del formulario: y puedes abrirlo haciendo clic en Abrir en Formularios.
Después de abrir el formulario nuevo en una ventana separada, intenta agregar algunas preguntas de forma manual. Luego, haz clic en Get Form by Id y verás tus preguntas nuevas en el resultado de JSON a la derecha.
Explora los otros métodos disponibles en la app y observa el resultado a la derecha para cada operación.
Cómo trabajar con los relojes de Forms
También observa los botones para los formularios de relojes. Estos ejemplos usan la función de supervisión de la API de Forms y realizan operaciones para crear, enumerar, borrar y renovar supervisores. 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 Forms y Cloud Pub/Sub, consulta Cómo configurar y recibir notificaciones push.
Próximos pasos
Intenta personalizar la app de ejemplo para que se adapte 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 completar formularios nuevos.
- Como alternativa, tu banco de preguntas puede residir en una base de datos SQL en la que puedes usar el servicio de JDBC de Apps Script para completar formularios con preguntas de la base de datos.
- Generar un cuestionario y guardar las calificaciones 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 del cuestionario.