Method: courses.courseWork.studentSubmissions.list

Devuelve una lista de las entregas de los estudiantes que el solicitante tiene permiso para ver, teniendo en cuenta los alcances de OAuth de la solicitud. Se puede especificar un guion (-) como courseWorkId para incluir las entregas de los estudiantes de varios elementos de trabajo del curso.

Los estudiantes del curso solo pueden ver su propio trabajo. Los profesores del curso y los administradores del dominio pueden ver todas las tareas enviadas por los estudiantes.

Este método devuelve los siguientes códigos de error:

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para acceder al curso o trabajo del curso solicitado, o por errores de acceso
  • 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

Parámetros
courseId

string

Es el identificador del curso. Este identificador puede ser el que asigna Classroom o un alias.
courseWorkId

string

Es el identificador del trabajo del estudiante que se solicita. Este parámetro se puede establecer en el literal de cadena "-" para solicitar el trabajo de los estudiantes para todo el trabajo del curso especificado.

Parámetros de consulta

Parámetros
userId

string

Argumento opcional para restringir el trabajo devuelto de los estudiantes a aquellos que pertenecen al estudiante con el identificador especificado. El identificador puede ser uno de los siguientes:

  • Identificador numérico del usuario
  • La dirección de correo electrónico del usuario
  • El literal de cadena "me", que indica el usuario solicitante
states[]

enum (SubmissionState)

Son los estados de envío solicitados. Si se especifica, las entregas de los estudiantes devueltas coinciden con uno de los estados de entrega especificados.
late

enum (LateValues)

Es el valor de retraso solicitado. Si se especifica, las entregas de los estudiantes que se devuelven se restringen según el valor solicitado. Si no se especifica, se devuelven los envíos independientemente del valor de late.
pageSize

integer

Es la cantidad máxima de elementos que se devolverán. El valor cero o no especificado indica que el servidor puede asignar un máximo.

Es posible que el servidor devuelva menos resultados de los que se especificaron.
pageToken

string

Valor de nextPageToken que se devolvió de una llamada list anterior, lo que indica que se debe devolver la página siguiente de resultados.

La solicitud list debe ser idéntica a la que generó este token.
previewVersion

enum (PreviewVersion)

Opcional. Es la versión preliminar de la API. Este parámetro debe configurarse para acceder a las nuevas capacidades de la API que se ponen a disposición de 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

Es la respuesta cuando se enumeran los envíos de los estudiantes.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Campos
studentSubmissions[]

object (StudentSubmission)

Trabajo del estudiante que coincide con la solicitud.
nextPageToken

string

Es un token que identifica la siguiente página de resultados que se devolverá. Si está vacío, no hay más resultados disponibles.

Permisos de autorización

Se necesita uno de los siguientes permisos 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 de retraso de los artículos devueltos.

Enums
LATE_VALUES_UNSPECIFIED No se especificó ninguna restricción en los valores de entrega tardía.
LATE_ONLY Devuelve StudentSubmissions donde late es verdadero.
NOT_LATE_ONLY Devuelve StudentSubmissions donde late es falso.