Method: courses.courseWorkMaterials.list

Muestra una lista del material de trabajo del curso que el solicitante tiene permitido 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 muestra los siguientes códigos de error:

  • PERMISSION_DENIED si el usuario que realiza la solicitud no tiene permiso para acceder al curso solicitado o 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}/courseWorkMaterials

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 que asignó Classroom o un alias.

Parámetros de consulta

Parámetros
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Restricción sobre el estado del trabajo que se debe devolver. Solo se devuelve el material del curso que coincide. Si no se especifica, se muestran los elementos con estado de trabajo PUBLISHED.

orderBy

string

Orden de clasificación opcional para los resultados. Una lista de campos separados por comas con una palabra clave opcional de dirección de ordenamiento. 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

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

string

Es el valor nextPageToken que se muestra en 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.

materialDriveId

string

Filtrado opcional para el material del trabajo del curso con al menos un material de Drive cuyo ID coincida con la string proporcionada. Si también se especifica materialLink, el material del trabajo del curso debe tener materiales que coincidan con ambos filtros.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta cuando se enumera el material de trabajo 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)

Elementos de material de trabajo del curso que coinciden con la solicitud.

nextPageToken

string

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.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

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