Los alumnos y los profesores son asignaciones específicas entre un perfil de usuario y un curso, que representan la función de ese usuario en el curso. Las designaciones de alumno y profesor no son globales: se puede asignar un usuario como profesor en un curso y un alumno en otro. La designación “alumno” o “profesor” representa un conjunto de permisos para un usuario específico en un curso determinado.
- Alumnos
- Un recurso para alumnos representa a un usuario que está inscrito como alumno en un curso específico. Los alumnos pueden ver los detalles del curso y a los profesores de ese curso.
- Profesores
- Un recurso para profesores representa a un usuario que imparte un curso específico. Los profesores pueden ver y cambiar los detalles del curso, ver a los profesores y alumnos, y administrar a los profesores y los alumnos adicionales.
Los alumnos y los profesores se identifican con el ID único o la dirección de correo electrónico del usuario, como lo muestra la API de Directory.
El usuario actual también puede hacer referencia a su propio ID con la abreviatura "me".
Adición directa
Los administradores del dominio pueden omitir el flujo de invitaciones y agregar directamente usuarios dentro de su dominio como profesores o alumnos a cursos dentro de su dominio. Un curso se considera dentro del dominio del administrador si el propietario del curso está dentro del dominio del administrador. En el caso de los usuarios o cursos fuera del dominio de un administrador de dominio autenticado, las aplicaciones deben obtener el consentimiento del usuario mediante el envío de una invitación con el método invitations.create().
Cómo agregar o quitar profesores
Los administradores de dominios pueden agregar directamente profesores dentro de su dominio a cursos con teachers.create(), como se muestra en el siguiente ejemplo:
.NET
Java
PHP
Python
Si quieres agregar profesores adicionales en nombre de un profesor autenticado, debes usar el método invitations.create().
Puedes quitar a otros profesores de un curso con el método teachers.delete(). Esto solo quita del curso al profesor especificado y no afecta su asignación a otros cursos ni su perfil de usuario.
Inscribir o quitar alumnos
Los administradores de dominios pueden agregar directamente a los alumnos dentro de su dominio con el método students.create(), como se muestra en el siguiente ejemplo:
.NET
Java
PHP
Python
Si agregas alumnos en nombre de un profesor autenticado, debes usar el método invitations.create().
Para quitar a un alumno de un curso, puedes usar el método students.delete(). Esto solo quita al estudiante especificado del curso y no afecta su inscripción en otros cursos ni su perfil de usuario.
Recuperar los cursos de un usuario
Si quieres recuperar una lista de cursos para un estudiante o un profesor, llama a courses.list() y proporciona el studentId o el teacherId del usuario correspondiente.
Cómo recuperar el perfil de un usuario
A fin de recuperar el perfil abreviado, que incluye el ID y el nombre de un usuario, llama a userProfiles.get() con el ID, el correo electrónico o “me” del usuario solicitante.
Para recuperar el campo emailAddress, debes incluir el permiso classroom.profile.emails.
El ID que se muestra corresponde al recurso de usuarios de la API de Directory que contiene los valores de studentId o teacherId coincidentes.
Administrar propietarios del curso
Los administradores de dominios pueden transferir la propiedad de los cursos entre profesores. Consulta la sección Cómo transferir la propiedad del curso para obtener detalles importantes.