La API de Google Classroom proporciona una interfaz de programación para que los desarrolladores de software, los administradores y los líderes escolares administren los recursos de Google Classroom. Puedes compilar software que cree, recupere y modifique cursos de Classroom y su contenido.
Estos son algunos casos prácticos típicos:
- Administración de cursos, listas y tutores
- Cómo agregar tareas, anuncios y materiales del curso
- Cómo asignar calificaciones y modificar la configuración de calificación
- Cómo generar datos para el análisis
- Hacer que el contenido o las herramientas de un proveedor externo sean detectables y accesibles en Classroom
¿La API de Classroom es la solución adecuada para mí?
Google ofrece varios productos para ayudarte a interactuar con Classroom. A continuación, se incluyen algunas situaciones comunes y recomendaciones para los productos que mejor se adapten a tus necesidades.
Modifica los recursos de Google Classroom
| Situación | Soluciones recomendadas |
|---|---|
| Quiero administrar regularmente una gran cantidad de cursos, usuarios o recursos de Classroom. Me siento cómodo escribiendo código y manteniendo la infraestructura de software. | Escribe aplicaciones que usen la API de Classroom. |
| Quiero administrar ocasionalmente un pequeño volumen de recursos de Classroom. Me siento cómodo escribiendo pequeñas cantidades de código con poca sobrecarga. | Usa la API de Classroom con Google Apps Script. |
| Quiero realizar cambios ocasionalmente en recursos individuales de Classroom. Me siento cómodo trabajando con comandos de terminal. | Usa Google Apps Manager. |
| Quiero una gran cantidad de informes con detalles sobre los eventos en Classroom. | Usa el Servicio de transferencia de datos de BigQuery. |
| Quiero investigar la actividad de mis usuarios. | Genera informes en la Consola del administrador o usa la API de Reports. |
Integración con Google Classroom
| Situación | Soluciones recomendadas |
|---|---|
| Quiero que los profesores y estudiantes vean y ejecuten mi contenido en Classroom. | Crea un complemento de Classroom. |
| Quiero que los profesores hagan clic en un botón de mi sitio web o aplicación que incorpore mi contenido en Classroom. | Compila un complemento de Classroom y crea archivos adjuntos de forma programática. |
| Quiero que los profesores hagan clic en un botón de mi sitio web o aplicación para vincular mi contenido en Classroom. | Crea tareas con la API de Classroom o incorpora botones de Compartir en Classroom. |
| Quiero que los profesores de Classroom sincronicen o importen información de mi sistema de información de estudiantes. | Implementa OneRoster para el SIE o crea recursos y accede a ellos con la API de Classroom. |
Cómo comenzar
Se recomienda a los desarrolladores nuevos que hagan lo siguiente antes de comenzar un proyecto nuevo:
- Lee nuestra guía sobre la estructura de la API de Classroom.
- Obtén información sobre las calificaciones, los tipos de usuarios, la elegibilidad de los usuarios y las acciones de los administradores. En estas guías, se explican conceptos exclusivos de Google Classroom y la API de Classroom.
- Comprende cómo funcionan las solicitudes a la API de Classroom.
Para comenzar a desarrollar, asegúrate de haber completado los pasos de los requisitos previos. Elige los alcances de la API de Classroom adecuados para tus necesidades, luego configura tu entorno y comienza a realizar solicitudes siguiendo una de las guías de inicio rápido:
Experimenta con el Explorador de APIs de Google
Para experimentar con la llamada a métodos en datos en vivo, prueba usar el Explorador de APIs de Google. No es necesario que escribas ningún código para comenzar, pero ten en cuenta que las acciones que realices con el Explorador de APIs pueden modificar los datos existentes.
Una forma de comenzar a llamar a los métodos es llamar al método courses.list(). Este método no requiere ningún parámetro de solicitud, y puedes recuperar un id de la lista de cursos que se muestra para usarlo como parámetro de solicitud para otras llamadas a la API. Si no tienes ningún curso, puedes crear uno con el método courses.create().
También puedes explorar la referencia de la API de Classroom.