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. - pode ser especificado como courseWorkId para incluir envios de estudantes para vários itens de trabalho do curso.

Os estudantes do curso só podem acessar o próprio trabalho. Os professores do curso e os administradores do domínio podem conferir 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 as atividades do curso solicitado ou em caso de 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. Ele pode ser definido como o literal de string "-" para solicitar o trabalho dos estudantes para todas as atividades do curso especificado.

Parâmetros de consulta

Parâmetros
userId

string

Argumento opcional para restringir os trabalhos devolvidos aos que pertencem ao 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 de envio solicitados. Se especificado, os envios de estudantes retornados correspondem a um dos estados de envio especificados.
late

enum (LateValues)

Valor de atraso solicitado. Se especificado, os envios de atividades de estudantes são 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 retornados. Zero ou indefinido indica que o servidor pode atribuir um valor máximo.

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

string

O 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 novos recursos de API disponibilizados para desenvolvedores no programa de visualização.

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)

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 há 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 ao valor dos itens devolvidos com atraso.

Enums
LATE_VALUES_UNSPECIFIED Nenhuma restrição aos valores de envio atrasado foi especificada.
LATE_ONLY Retorna as atividades dos estudantes em que "late" é verdadeiro.
NOT_LATE_ONLY Retorna StudentSubmissions em que "late" é falso.