Method: courses.courseWork.studentSubmissions.list

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

Os estudantes do curso só podem acessar os próprios trabalhos. Professores do curso e administradores do domínio têm acesso a 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 devido a erros de acesso.
  • INVALID_ARGUMENT se a solicitação for inválida.
  • 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 pelo Google Sala de Aula ou um alias.

courseWorkId

string

Identificador do trabalho do estudante a ser solicitado. Isso pode ser definido como o literal de string "-" para solicitar que os estudantes façam todos os trabalhos do curso especificado.

Parâmetros de consulta

Parâmetros
userId

string

Argumento opcional para restringir os trabalhos devolvidos aos trabalhos do estudante 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 do envio solicitado. 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 vão ser restritos pelo valor solicitado. Se não for especificado, os envios serão retornados, independentemente do valor de late.

pageSize

integer

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

O servidor pode retornar menos do 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.

previewVersion

enum (PreviewVersion)

Opcional. A versão de pré-lançamento da API. Isso precisa ser definido para acessar os novos recursos da 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 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)

O trabalho do estudante corresponde à 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.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 sobre o valor atrasado dos itens devolvidos.

Enums
LATE_VALUES_UNSPECIFIED Nenhuma restrição quanto aos valores de envios atrasados especificados.
LATE_ONLY Devolver StudentSubmissions quando o atraso for verdadeiro.
NOT_LATE_ONLY Retorne StudentSubmissions quando o atraso for falso.