La API de Google Classroom proporciona una interfaz de programación para que los desarrolladores de software, los administradores y los líderes educativos administren los recursos de Google Classroom. Puedes compilar software que cree, recupere y modifique los 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
- 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 de productos que podrían adaptarse mejor a tus necesidades.
Modifica los recursos de Google Classroom
| Situación | Soluciones recomendadas |
|---|---|
| Quiero administrar con regularidad un gran volumen de cursos, usuarios y otros recursos de Classroom. Me siento cómodo escribiendo código y manteniendo la infraestructura de software. | Escribir aplicaciones que usen la API de Classroom |
| Quiero administrar ocasionalmente un pequeño volumen de recursos de Classroom. Me siento a gusto escribiendo pequeñas cantidades de código con poca sobrecarga. | Usa la API de Classroom con Google Apps Script. |
| Quiero realizar cambios ocasionales en recursos individuales de Classroom. Me siento cómodo trabajando con comandos de la terminal. | Usa el Administrador de apps de Google. |
| Quiero un gran volumen de informes con detalles sobre los eventos en Classroom. | Usa el Servicio de transferencia de datos de BigQuery. |
| Quiero realizar una investigación sobre la actividad de mis usuarios. | Genera informes en la Consola del administrador o usa la API de Reports. |
Cómo realizar la integración a Google Classroom
| Situación | Soluciones recomendadas |
|---|---|
| Quiero que los profesores y los alumnos vean y lancen mi contenido en Classroom. | Compila un complemento de Classroom. |
| Quiero que los profesores hagan clic en un botón de mi sitio web o aplicación para incorporar 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 trabajos con la API de Classroom o incorpora botones para compartir en Classroom. |
| Quiero que los profesores de Classroom accedan a mi sistema de información de alumnos o importen información desde él. | Implementa OneRoster para 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 del administrador. 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 previos. Elige los alcances de la API de Classroom adecuados para tus necesidades, configura tu ambiente 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 llamadas a métodos en datos en vivo, usa 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.