Method: courses.courseWork.studentSubmissions.list

Retorna uma lista de envios dos alunos que o solicitante tem permissão para visualizar, considerando os escopos do OAuth da solicitação. - pode ser especificado como courseWorkId para incluir os envios dos estudantes em vários itens de trabalho do curso.

Os estudantes do curso só podem ver o próprio trabalho. Os professores do curso e administradores do domínio podem ver todos os envios dos estudantes.

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 ou o trabalho do curso solicitado ou se houver 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}/courseWork/{courseWorkId}/studentSubmissions

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 ao Google Sala de Aula ou alias.
courseWorkId

string

Identificador do trabalho do estudante a ser solicitado. Pode ser definido como o literal de string "-" para solicitar o trabalho do estudante em todos os trabalhos do curso especificado.

Parâmetros de consulta

Parâmetros
userId

string

Argumento opcional para restringir os trabalhos devolvidos aos estudantes com o identificador especificado. O identificador pode ser um dos seguintes:

  • o identificador numérico do usuário
  • o endereço de e-mail do usuário
  • o literal de string "me", indicando o usuário solicitante
states[]

enum (SubmissionState)

Estados de envio solicitados. Se especificado, os envios devolvidos dos estudantes correspondem a um dos estados de envio especificados.
late

enum (LateValues)

Valor de atraso solicitado. Se especificado, os envios devolvidos dos estudantes são restritos pelo valor solicitado. Se não for especificado, os envios serão retornados, seja qual for o valor de late.
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 que o especificado.
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.
previewVersion

enum (PreviewVersion)

Opcional. A versão de pré-lançamento da API. Isso precisa ser definido para acessar as novas funcionalidades da API disponibilizadas para os desenvolvedores no Programa de testes.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao listar os envios dos estudantes.

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

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

object (StudentSubmission)

Trabalho do estudante que corresponde à solicitação.
nextPageToken

string

Token que identifica a próxima página de resultados a serem retornados. Se estiver vazio, nenhum outro resultado estará disponível.

Escopos de autorização

Requer um dos seguintes escopos do 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 mais informações, consulte o Guia de autorização.

LateValues

Restrições do valor atrasado de itens retornados.

Enums
LATE_VALUES_UNSPECIFIED Nenhuma restrição quanto aos valores de atraso de envio especificados.
LATE_ONLY Retorna StudentSubmissions quando atrasado for verdadeiro.
NOT_LATE_ONLY Retorna StudentSubmissions quando atrasado for falso.