Method: courses.courseWorkMaterials.list

Retorna uma lista de materiais de atividades escolares que o solicitante tem permissão para visualizar.

Os estudantes do curso só podem acessar o material de trabalho do curso PUBLISHED. Os professores do curso e os administradores do domínio podem acessar todo o material do curso.

Esse método retorna os seguintes códigos de erro:

  • PERMISSION_DENIED se o usuário solicitante não tiver permissão para acessar o curso solicitado ou por erros de acesso.
  • INVALID_ARGUMENT se a solicitação estiver incorreta.
  • NOT_FOUND se o curso solicitado não existir.

Solicitação HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
courseId

string

Identificador do curso. Esse identificador pode ser o atribuído pelo Google Sala de Aula ou um alias.

Parâmetros de consulta

Parâmetros
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Restrição no status de trabalho a ser retornado. Somente o material de trabalho do curso que corresponde é retornado. Se não for especificado, os itens com um status de trabalho PUBLISHED serão retornados.
orderBy

string

Ordenação de classificação opcional para resultados. Uma lista separada por vírgulas de campos com uma palavra-chave de direção de classificação opcional. O campo aceito é updateTime. As palavras-chave de direção aceitas são asc e desc. Se não for especificado, updateTime desc será o comportamento padrão. Exemplos: updateTime asc, updateTime
pageSize

integer

Número máximo de itens a serem retornados. Zero ou não especificado indica que o servidor pode atribuir um máximo.

O servidor pode retornar menos resultados do que o número especificado.
pageToken

string

Valor nextPageToken retornado de uma chamada list anterior, indicando que a página de resultados subsequente deve ser retornada.

A solicitação list precisa ser idêntica àquela que resultou neste token.
materialDriveId

string

Filtragem opcional para material de trabalho do curso com pelo menos um material do Drive cujo ID corresponda à string fornecida. Se materialLink também for especificado, o material do curso precisará corresponder aos dois filtros.
previewVersion

enum (PreviewVersion)

Opcional. A versão de prévia da API. Isso precisa ser definido para acessar os novos recursos de API disponibilizados aos desenvolvedores no Programa de testes.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao listar material de trabalho do curso.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
Campos
courseWorkMaterial[]

object (CourseWorkMaterial)

Itens de material de trabalho do curso que correspondem à solicitação.
nextPageToken

string

Token que identifica a próxima página de resultados a serem retornados. Se estiver vazio, não haverá mais resultados disponíveis.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Para mais informações, consulte o guia de autorização.