Method: courses.courseWorkMaterials.list

Devuelve una lista del material de trabajo del curso que el solicitante tiene permiso para ver.

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

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para acceder al 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}/courseWorkMaterials

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.

Parámetros de consulta

Parámetros
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Es la restricción sobre el estado laboral que se devolverá. Solo se devuelve el material del curso que coincide. Si no se especifica, se devuelven los elementos con el estado de trabajo PUBLISHED.
orderBy

string

Orden de clasificación opcional para los resultados. Es una lista separada por comas de campos con una palabra clave de dirección de ordenamiento opcional. El campo admitido es updateTime. Las palabras clave de dirección admitidas son asc y desc. Si no se especifica, updateTime desc es el comportamiento predeterminado. Ejemplos: updateTime asc, updateTime
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.
materialDriveId

string

Es un filtro opcional para el material de trabajo del curso que incluye al menos un material de Drive cuyo ID coincide con la cadena proporcionada. Si también se especifica materialLink, el material del curso debe coincidir con ambos filtros.
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 enumera el material del curso.

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

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

object (CourseWorkMaterial)

Son los elementos de material del curso que coinciden 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.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Para obtener más información, consulta la Guía de autorización.