REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Envio de trabalhos do curso por estudantes.

Os itens StudentSubmission são gerados quando um item CourseWork é criado.

Os envios de estudantes que nunca foram acessados (ou seja, com state = NEW) podem não ter um horário de criação ou de atualização.

Representação JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Campos
courseId

string

Identificador do curso.

Somente leitura.
courseWorkId

string

Identificador da atividade do curso correspondente.

Somente leitura.
id

string

Identificador atribuído pelo Google Sala de Aula para o envio do estudante. Ele é exclusivo entre as entregas da atividade do curso em questão.

Somente leitura.
userId

string

Identificador do estudante que é proprietário do envio.

Somente leitura.
creationTime

string (Timestamp format)

Hora de criação do envio. Esse campo pode não estar definido se o estudante não tiver acessado o item.

Somente leitura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Horário da última atualização deste envio. Esse campo pode não estar definido se o estudante não tiver acessado o item.

Somente leitura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Estado deste envio.

Somente leitura.
late

boolean

Se o envio está atrasado.

Somente leitura.
draftGrade

number

Nota pendente opcional. Se não estiver definida, nenhuma nota foi definida. Esse valor não pode ser negativo. Valores decimais (ou seja, não inteiros) são permitidos, mas são arredondados para duas casas decimais.

Somente os professores do curso podem ver e modificar essa informação.
assignedGrade

number

Nota opcional. Se não estiver definida, nenhuma nota foi definida. Esse valor não pode ser negativo. Valores decimais (ou seja, não inteiros) são permitidos, mas são arredondados para duas casas decimais.

Isso só pode ser modificado pelos professores do curso.
rubricId

string

Apenas saída. Identificador da rubrica atualmente anexada a esta atividade e usada para avaliar o envio do estudante.

Esse ID fica vazio se não houver uma rubrica. Esse ID reflete a rubrica ativa no momento. Ele muda se os professores excluem e recriam a rubrica.

Somente leitura.

draftRubricGrades

map (key: string, value: object (RubricGrade))

Notas de rubrica pendentes com base nos critérios da rubrica.

Esse mapa fica vazio se não houver uma rubrica anexada à atividade ou se houver uma rubrica anexada, mas nenhuma nota tiver sido definida em nenhum critério. As entradas são preenchidas apenas para as notas que foram definidas. Chave: o ID do critério da rubrica.

Somente leitura.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Notas de rubrica atribuídas com base nos critérios da rubrica.

Esse mapa estará vazio se não houver uma rubrica anexada à atividade do curso ou se houver uma rubrica anexada, mas nenhuma nota tiver sido definida em nenhum critério. As entradas são preenchidas apenas para as notas que foram definidas. Chave: o ID do critério da rubrica.

Somente leitura.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Tipo de trabalho do curso a que o envio se refere.

Somente leitura.
associatedWithDeveloper

boolean

Se o envio do estudante está associado ao projeto do Console do Desenvolvedor que faz a solicitação.

Consulte courseWork.create para mais detalhes.

Somente leitura.
submissionHistory[]

object (SubmissionHistory)

O histórico do envio (inclui os históricos de estado e nota).

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. A versão de pré-lançamento da API. Isso precisa ser definido para acessar os novos recursos de API disponibilizados aos desenvolvedores no Programa de Pré-lançamento.
Conteúdo enviado. O tipo específico depende do valor de course_work_type. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
assignmentSubmission

object (AssignmentSubmission)

Conteúdo do envio quando courseWorkType é ASSIGNMENT.

Os estudantes podem modificar esse conteúdo usando o studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Conteúdo do envio quando courseWorkType é SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Conteúdo do envio quando courseWorkType é MULTIPLE_CHOICE_QUESTION.
Fim dos campos mutuamente exclusivos.

RubricGrade

Uma nota de rubrica definida para o envio do estudante. Há no máximo uma entrada por critério de rubrica.

Representação JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Campos
criterionId

string

Opcional. ID do critério.
levelId

string

Opcional. ID opcional do nível selecionado. Se estiver vazio, nenhum nível foi selecionado.
points

number

Opcional. Pontos opcionais atribuídos a esse critério, geralmente com base no nível. Os níveis podem ou não ter pontos. Se não for definido, nenhum ponto será definido para esse critério.

AssignmentSubmission

Trabalho de um estudante em uma atividade.

Representação JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Campos
attachments[]

object (Attachment)

Anexos adicionados pelo estudante. Os arquivos do Drive que correspondem a materiais com o modo de compartilhamento STUDENT_COPY podem não existir se o estudante não tiver acessado a atividade no Google Sala de Aula.

Alguns metadados de anexos só são preenchidos se o usuário solicitante tiver permissão para acessá-los. Os campos identifier e alternateLink estão sempre disponíveis, mas outros (por exemplo, title) podem não estar.

Anexo

Anexo adicionado ao trabalho atribuído do estudante.

Ao criar anexos, não é possível definir o campo form.

Representação JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Campos
Dados do anexo. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
driveFile

object (DriveFile)

Anexo de arquivo do Google Drive.
youTubeVideo

object (YouTubeVideo)

Anexo de vídeo do YouTube.
form

object (Form)

Anexo do Google Formulários.
Fim dos campos mutuamente exclusivos.

ShortAnswerSubmission

Trabalho do estudante para uma pergunta de resposta curta.

Representação JSON 
{
  "answer": string
}
Campos
answer

string

Resposta de um estudante a uma pergunta de resposta curta.

MultipleChoiceSubmission

Trabalho do estudante para uma pergunta de múltipla escolha.

Representação JSON 
{
  "answer": string
}
Campos
answer

string

Escolha do estudante.

SubmissionHistory

O histórico do envio. No momento, isso inclui históricos de estado e nota.

Representação JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Campos
Tipo de SubmissionHistory, que pode ser StateHistory ou GradeHistory. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
stateHistory

object (StateHistory)

As informações do histórico de estado do envio, se houver.
gradeHistory

object (GradeHistory)

As informações do histórico de notas do envio, se houver.
Fim dos campos mutuamente exclusivos.

StateHistory

O histórico de cada estado em que o envio esteve.

Representação JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Campos
state

enum (State)

A fase do pipeline do fluxo de trabalho.
stateTimestamp

string (Timestamp format)

Quando o envio entrou nesse estado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
actorUserId

string

O professor ou estudante que fez a mudança.

Estado

Estados possíveis para um envio.

Tipos enumerados
STATE_UNSPECIFIED Nenhum estado especificado. Isso nunca deve ser retornado.
CREATED O envio foi criado.
TURNED_IN O estudante entregou um documento atribuído, que pode ou não ser um modelo.
RETURNED O professor devolveu o documento atribuído ao estudante.
RECLAIMED_BY_STUDENT O estudante entregou o documento atribuído e depois escolheu "Cancelar envio" da atividade, o que devolveu o controle a ele como proprietário.
STUDENT_EDITED_AFTER_TURN_IN O estudante editou o envio depois de entregá-lo. No momento, usado apenas por perguntas, quando o estudante edita a resposta.

GradeHistory

O histórico de cada nota nesta entrega.

Representação JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Campos
pointsEarned

number

O numerador da nota no momento no histórico de notas do envio.
maxPoints

number

O denominador da nota no momento do histórico de notas do envio.
gradeTimestamp

string (Timestamp format)

Quando a nota do envio foi alterada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
actorUserId

string

O professor que fez a mudança na nota.
gradeChangeType

enum (GradeChangeType)

O tipo de mudança de nota no histórico de notas da atividade.

GradeChangeType

Possíveis tipos de mudança de nota.

Tipos enumerados
UNKNOWN_GRADE_CHANGE_TYPE Nenhum tipo de mudança de nota foi especificado. Isso nunca deve ser retornado.
DRAFT_GRADE_POINTS_EARNED_CHANGE Uma mudança no numerador da nota do rascunho.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Uma mudança no numerador da nota atribuída.
MAX_POINTS_CHANGE Uma mudança no denominador da nota.

Métodos

get

 Retorna o envio de um estudante.

list

 Retorna uma lista de envios de estudantes que o solicitante tem permissão para ver, considerando os escopos do OAuth da solicitação.

modifyAttachments

 Modifica os anexos do envio de um estudante.

patch

 Atualiza um ou mais campos de um envio de estudante.

reclaim

 Reivindica uma atividade em nome do estudante que é o proprietário dela.

return

 Retorna o envio de um estudante.

turnIn

 Entrega um envio de estudante.