En esta página, se enumeran algunos malentendidos y casos extremos comunes que debes tener en cuenta cuando diseñes y, luego, implementes tu complemento de Classroom. Te recomendamos que implementes protecciones contra fallas y pruebas que incluyan estos casos.
Conceptos de Google Classroom
En esta sección, se destacan los casos extremos y los conceptos relevantes para los complementos que se aplican a todo Google Classroom.
Cursos y roles del usuario
Un curso es la unidad organizativa central que conecta a los profesores con los estudiantes. Los cursos son el nivel más alto de organización en la API de Google Classroom.
Los usuarios individuales se pueden agregar a un curso como “profesores” o “alumnos”. El rol de un usuario en el curso no está vinculado a su rol en la institución. Esto significa que un miembro estudiante de la institución puede ser profesor en un curso, y los miembros profesores pueden ser estudiantes en los cursos. Si bien el caso más común es que un curso represente una asignatura académica programada con regularidad, también se crean cursos para organizar clubes estudiantiles o realizar desarrollo profesional.
Lo siguiente se aplica a todos los cursos de Google Classroom.
A los profesores de los cursos:
- Un curso puede tener más de un profesor.
- Los profesores se pueden agregar a un curso en cualquier momento.
- Los profesores pueden quitarse de un curso en cualquier momento.
Elemento de transmisión
Los elementos de la transmisión son los elementos de contenido publicados que se comparten con los miembros de un curso. Los desarrolladores y los profesores pueden crear archivos adjuntos de complementos en tres tipos de elementos de las novedades: anuncios, tareas y materiales.
Los profesores crean anuncios en la parte superior de la página Novedades en la IU de Classroom. Para crear tareas y materiales, los profesores deben hacer clic en el botón Crear en la pestaña Trabajo en clase. Los desarrolladores pueden crearlos de forma programática a través de la API de Classroom.
Una tarea es un elemento de transmisión que puede aceptar la entrega de un estudiante. Las tareas son el único tipo de elemento del flujo que aparece en el libro de calificaciones y que puede contener un archivo adjunto de complemento.
Acerca de los elementos de transmisión:
- Se puede asignar una tarea o un material a un subconjunto de los estudiantes del curso.
- Las tareas pueden tener o no una calificación. Los profesores pueden cambiar el estado de calificación de una tarea en cualquier momento.
- Una tarea puede tener más de un archivo adjunto.
- Una tarea puede tener archivos adjuntos de diferentes tipos. Por ejemplo, una tarea puede tener Documentos de Google, videos de YouTube y archivos adjuntos de complementos de forma simultánea.
- Una tarea puede tener archivos adjuntos de complementos de más de un desarrollador.
- Los desarrolladores pueden obtener y modificar información sobre cualquier elemento de novedades con uno de sus archivos adjuntos de complementos.
- Los desarrolladores pueden entregar, reclamar o devolver la entrega de un estudiante para una tarea que incluya uno de sus archivos adjuntos de complementos.
- Los desarrolladores solo pueden establecer calificaciones para las tareas individuales que los estudiantes entreguen en las tareas que crearon.
Elementos de transmisión copiados
Los profesores pueden copiar un elemento de transmisión copiando un curso, reutilizando una tarea o publicando un elemento de transmisión en varios cursos. Lee nuestra guía sobre contenido copiado para comprender cómo el complemento puede controlar estas situaciones.
Institución del usuario
La API de Google Classroom no muestra identificadores para la institución, el edificio ni cualquier otra membresía de un usuario por encima del nivel del curso.