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 alumnos y profesores no son globales: se puede asignar a un usuario como profesor para un curso y a un alumno en otro. La designación "estudiante" o "profesor" representa un conjunto de permisos para un usuario específico en un curso en particular.
- 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 los profesores de ese curso.
- Profesores
- Un recurso de profesor representa a un usuario que dicta un curso específico. Los profesores pueden ver y cambiar los detalles del curso, además de ver a los profesores y los alumnos, y administrar a los demás profesores y alumnos.
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"
.
Agregar directamente
Los administradores del dominio pueden omitir el flujo de invitaciones y agregar usuarios de forma directa 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á en el dominio del administrador. Para 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 dominio pueden agregar profesores dentro de su dominio directamente a los cursos con teachers.create()
, como se muestra en el siguiente ejemplo:
.NET
Java
PHP
Python
Si agregas profesores adicionales en nombre de un profesor autenticado, debes usar el método invitations.create()
.
Puedes quitar a los profesores adicionales de un curso con el método teachers.delete()
. Esto solo quita al profesor especificado del curso y no afecta su tarea a otros cursos o su perfil de usuario.
Inscribir o quitar alumnos
Los administradores de dominio pueden agregar estudiantes directamente en su dominio con el método students.create()
, como se muestra en la siguiente muestra:
.NET
Java
PHP
Python
Si agregas alumnos en nombre de un profesor autenticado, debes usar el método invitations.create()
.
Puedes quitar a un alumno de un curso con el método students.delete()
. Esta acción solo quita del curso al alumno especificado y no afecta su inscripción en otros cursos ni su perfil de usuario.
Recuperar los cursos de un usuario
Para recuperar una lista de cursos de un alumno o profesor, llama a courses.list()
y proporciona los studentId
o teacherId
correspondientes.
Recuperar el perfil de un usuario
A fin de recuperar el perfil abreviado, incluido el ID y el nombre de un usuario, llama a userProfiles.get()
con el ID, el correo electrónico o el “yo” 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 studentId
o teacherId
coincidentes.
Administrar propietarios de cursos
Los administradores de dominio pueden transferir la propiedad de los cursos entre profesores. Consulta la sección Transferir la propiedad del curso para obtener detalles importantes.