- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- LateValues
- Pruébala
Muestra una lista de las entregas de los estudiantes que el solicitante puede ver, teniendo en cuenta los alcances de OAuth de la solicitud. -
se puede especificar como courseWorkId
para incluir las entregas de los estudiantes de varios elementos de los trabajos del curso.
Los alumnos del curso solo pueden ver su propio trabajo. Los profesores de cursos y los administradores del dominio pueden ver todas las entregas de los estudiantes.
Este método muestra los siguientes códigos de error:
PERMISSION_DENIED
si el usuario que realiza la solicitud no tiene permiso para acceder al curso o trabajo del curso solicitado, o bien por errores de acceso.- Es
INVALID_ARGUMENT
si la solicitud tiene un formato incorrecto. NOT_FOUND
si el curso solicitado no existe.
Solicitud HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
courseId |
Es el identificador del curso. Este identificador puede ser el que asignó Classroom o un |
courseWorkId |
Es el identificador del trabajo del estudiante que se va a solicitar. Se puede establecer como el literal de string |
Parámetros de consulta
Parámetros | |
---|---|
userId |
Argumento opcional para restringir el trabajo devuelto del estudiante a aquellos que son propiedad del estudiante con el identificador especificado. El identificador puede ser uno de los siguientes:
|
states[] |
Estados de envío solicitados Si se especifica, las entregas de los estudiantes que se devuelven coinciden con uno de los estados de entrega especificados. |
late |
Valor de retraso solicitado. Si se especifica, las entregas de los estudiantes están restringidas por el valor solicitado. Si no se especifica, se muestran los envíos sin importar el valor de |
pageSize |
Cantidad máxima de artículos que se devolverán. Cero o no especificado indica que el servidor puede asignar un máximo. Es posible que el servidor muestre menos resultados que la cantidad especificada. |
pageToken |
Es el valor La solicitud |
previewVersion |
Opcional. Es la versión preliminar de la API. Esto se debe configurar para acceder a las nuevas funciones de la API que están disponibles para los desarrolladores en el Programa de versión preliminar. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Respuesta al enumerar las entregas de los estudiantes.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"studentSubmissions": [
{
object ( |
Campos | |
---|---|
studentSubmissions[] |
Trabajo del estudiante que coincide con la solicitud |
nextPageToken |
Token que identifica la siguiente página de resultados que se mostrarán. Si este campo está vacío, no habrá más resultados disponibles. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
Para obtener más información, consulta la guía de autorización.
LateValues
Restricciones sobre el valor tardío de los artículos mostrados.
Enumeradores | |
---|---|
LATE_VALUES_UNSPECIFIED |
No se especificó ninguna restricción para los valores de envío retrasados. |
LATE_ONLY |
Devuelve las entregas de estudiantes cuando la demora es verdadera. |
NOT_LATE_ONLY |
Devuelve las entregas de los estudiantes cuando el retraso es falso. |