Method: courses.courseWork.list

Devuelve una lista del trabajo del curso que el solicitante puede ver.

Los estudiantes del curso solo pueden ver PUBLISHED trabajos del curso. Los profesores y los administradores del dominio del curso pueden ver todo el trabajo del curso.

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 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

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.

Parámetros de consulta

Parámetros
courseWorkStates[]

enum (CourseWorkState)

Restricciones sobre el estado del trabajo que se mostrará. Solo se devuelve CourseWork que coincide. Si no se especifica, se muestran los elementos con un estado de trabajo de PUBLISHED.

orderBy

string

Orden de clasificación opcional de los resultados. Una lista de campos separados por comas con una palabra clave opcional de dirección de orden. Los campos admitidos son updateTime y dueDate. Las palabras clave de dirección admitidas son asc y desc. Si no se especifica, updateTime desc es el comportamiento predeterminado. Ejemplos: dueDate asc,updateTime desc, updateTime,dueDate desc

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

Respuesta al enumerar el trabajo del curso.

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

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

object (CourseWork)

Elementos de trabajo del curso que coinciden 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.