La API de Google Classroom proporciona una interfaz de programación para que desarrolladores de software, administradores y 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
- Agregar tareas, anuncios y materiales del curso
- Cómo asignar calificaciones y modificar su configuración
- Generación de datos para 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 muestran algunas situaciones comunes y recomendaciones para los productos que podrían adaptarse mejor a tus necesidades.
Modifica los recursos de Google Classroom
| Situación | Soluciones recomendadas |
|---|---|
| Quiero administrar a menudo 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. |
| De vez en cuando, quiero hacer cambios en recursos individuales de Classroom. Me siento cómodo trabajando con comandos de la terminal. | Usa el Administrador de apps de Google. |
| Quiero tener un gran volumen de informes con detalles sobre los eventos de 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. |
Realiza la integración en Google Classroom
| Situación | Soluciones recomendadas |
|---|---|
| Quiero que los profesores y los alumnos vean y lancen 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 trabajos con la API de Classroom o incorpora botones para compartir en Classroom. |
| Quiero que los profesores de Classroom se sincronicen con mi Sistema de información de alumnos o que la importen. | 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 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 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.