Method: courses.courseWork.studentSubmissions.list

Retorna uma lista de envios de estudantes que o solicitante tem permissão para visualizar, considerando os escopos OAuth da solicitação. Um hífen (-) pode ser especificado como courseWorkId para incluir atividades enviadas pelos estudantes em vários itens de trabalho do curso.

Os estudantes do curso só podem acessar os próprios trabalhos. Os professores do curso e os administradores do domínio podem acessar 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 a atividade do curso solicitada 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}/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 o atribuído pelo Google Sala de Aula ou um alias.
courseWorkId

string

Identificador do trabalho do estudante a ser solicitado. Pode ser definido como a string literal "-" para solicitar o trabalho do estudante em todas as atividades do curso especificado.

Parâmetros de consulta

Parâmetros
userId

string

Argumento opcional para restringir os trabalhos devolvidos aos estudantes que têm 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 de estudantes retornados corresponderão a um dos estados de envio especificados.
late

enum (LateValues)

Valor de atraso solicitado. Se especificado, os envios de estudantes retornados serão restritos pelo valor solicitado. Se não for especificado, os envios serão retornados independente do 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 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.
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 prévia.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao listar 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)

Trabalhos dos estudantes 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.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 no valor atrasado dos itens devolvidos.

Tipos enumerados
LATE_VALUES_UNSPECIFIED Nenhuma restrição especificada para valores atrasados de envio.
LATE_ONLY Retorna StudentSubmissions em que "late" é verdadeiro.
NOT_LATE_ONLY Retorna StudentSubmissions em que "late" é "false".