Method: courses.courseWorkMaterials.list

Retorna uma lista de materiais do curso que o solicitante tem permissão para visualizar.

Os alunos do curso só podem ver PUBLISHED material de atividades do curso. Os professores e administradores de domínio do curso podem ver todos os materiais de trabalho 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 para 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 atribuído pelo Google Sala de Aula ou um alias.

Parâmetros de consulta

Parâmetros
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Restrição ao status do trabalho a ser retornado. Somente o material de trabalho do curso correspondente é retornado. Se não for especificado, os itens com status de trabalho PUBLISHED serão retornados.

orderBy

string

Ordem de classificação opcional para resultados. Uma lista de campos separados por vírgula com uma palavra-chave opcional de direção de classificação. O campo aceito é updateTime. As palavras-chave de direção compatíveis 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 que o número especificado de resultados.

pageToken

string

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

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

materialDriveId

string

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

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

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

Resposta ao listar materiais de trabalho do curso.

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

object (CourseWorkMaterial)

Materiais de trabalho do curso que correspondam à 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 de 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.