Method: courses.courseWork.studentSubmissions.list

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

Los estudiantes del curso solo pueden ver sus propios trabajos. Los profesores del curso y los administradores del dominio pueden ver todas las entregas de los alumnos.

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

  • Se utiliza PERMISSION_DENIED si el usuario que realizó la solicitud no tiene permiso para acceder al curso o trabajo del curso solicitado, o si tiene errores de acceso.
  • Es INVALID_ARGUMENT si la solicitud no tiene el formato correcto.
  • 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

string

Es el identificador del curso. Este identificador puede ser el asignado por Classroom o un alias.
courseWorkId

string

Identificador del trabajo del estudiante que se solicitará. Se puede establecer en el literal de string "-" para solicitar todos los trabajos de los estudiantes del curso en cuestión.

Parámetros de consulta

Parámetros
userId

string

Es un 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:

  • el identificador numérico del usuario
  • la dirección de correo electrónico del usuario
  • el literal de string "me", que indica el usuario solicitante
states[]

enum (SubmissionState)

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

enum (LateValues)

Valor de retraso solicitado. Si se especifica, las entregas devueltas de los estudiantes estarán restringidas por el valor solicitado. Si no se especifica, se muestran envíos independientemente del valor de late.
pageSize

integer

Cantidad máxima de elementos que se mostrarán. Cero o sin especificar indica que el servidor puede asignar un máximo.

Es posible que el servidor muestre menos resultados que la cantidad especificada.
pageToken

string

Es el valor de nextPageToken que se muestra desde una llamada a list anterior, lo que indica que se debe mostrar la página de resultados posterior.

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

enum (PreviewVersion)

Opcional. La versión preliminar de la API. Esto se debe establecer para acceder a las nuevas capacidades 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

Responder cuando se enumeren 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 (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Campos
studentSubmissions[]

object (StudentSubmission)

Trabajo del estudiante que coincide con la solicitud.
nextPageToken

string

Token que identifica la página siguiente de resultados que se mostrarán. Si está vacío, no habrá más resultados disponibles.

Alcances 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 tardío de los artículos devueltos.

Enumeraciones
LATE_VALUES_UNSPECIFIED No se especificaron restricciones para los valores tardíos del envío.
LATE_ONLY Devuelve las entregas de StudentSubmissions cuando se cumple con las condiciones retrasadas.
NOT_LATE_ONLY Devuelve StudentSubmissions cuando el valor de retraso es falso.