REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Envio de trabalhos escolares pelos estudantes.

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

As atividades enviadas pelos estudantes que nunca foram acessadas (ou seja, com state = NEW) podem não ter um horário de criação ou 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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Campos
courseId

string

Identificador do curso.

Somente leitura.
courseWorkId

string

Identificador da atividade do curso a que isso corresponde.

Somente leitura.
id

string

Identificador atribuído pela Sala de Aula para o envio do estudante. Ela é única entre os envios do trabalho do curso relevante.

Somente leitura.
userId

string

Identificador do estudante proprietário do envio.

Somente leitura.
creationTime

string (Timestamp format)

Hora de criação desta inscrição. Esse campo pode ficar vazio 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 desta inscrição. Esse campo pode ficar vazio 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

Indica se o envio está atrasado.

Somente leitura.
draftGrade

number

Nota pendente opcional. Se não estiver definido, nenhuma nota foi atribuída. 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.

Essa opção só fica visível e pode ser modificada pelos professores do curso.
assignedGrade

number

Nota opcional. Se não estiver definido, nenhuma nota foi atribuída. 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.

Essa opção só pode ser modificada pelos professores do curso.
rubricId

string

Apenas saída. Identificador da rubrica anexada a este trabalho do curso 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 e muda se os professores excluírem e recriarem a rubrica.

Somente leitura.

draftRubricGrades

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

Notas pendentes com base nos critérios da rubrica.

Esse mapa fica vazio se não houver uma rubrica anexada ao trabalho do curso ou se houver uma rubrica anexada, mas nenhuma nota tiver sido definida em nenhum critério. As entradas só são preenchidas para 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 atribuídas com base nos critérios da rubrica.

Esse mapa fica vazio se não houver uma rubrica anexada ao trabalho do curso ou se houver uma rubrica anexada, mas nenhuma nota tiver sido definida em nenhum critério. As entradas só são preenchidas para 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 este envio se destina.

Somente leitura.
associatedWithDeveloper

boolean

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

Consulte courseWork.create para mais detalhes.

Somente leitura.
submissionHistory[]

object (SubmissionHistory)

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

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. 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.
Campo de união content. Conteúdo do envio. O tipo específico depende do valor de course_work_type. content pode ser apenas de um dos tipos a seguir:
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.

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 estiver definido, nenhum ponto foi 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 correspondentes a materiais com o modo de compartilhamento STUDENT_COPY talvez ainda não existam 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 acessar. Os campos "identifier" e "alternateLink" estão sempre disponíveis, mas outros (por exemplo, "title") podem não estar.

Anexo

Anexo adicionado ao trabalho de uma atividade do estudante.

Não é possível definir o campo form ao criar anexos.

Representação JSON 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Campos
Campo de união attachment. Dados de anexos. attachment pode ser apenas de um dos tipos a seguir:
driveFile

object (DriveFile)

Anexo de arquivo do Google Drive.
youTubeVideo

object (YouTubeVideo)

Anexo de vídeo do YouTube.
form

object (Form)

Anexo do Formulários Google.

ShortAnswerSubmission

Trabalho de um estudante em 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 de um estudante em uma pergunta de múltipla escolha.

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

string

Opção de seleção do estudante.

SubmissionHistory

O histórico do envio. Isso inclui o histórico de estado e de notas.

Representação JSON 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Campos
Campo de união type. Tipo de SubmissionHistory, que pode ser StateHistory ou GradeHistory. type pode ser apenas de um dos tipos a seguir:
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.

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)

O estágio do pipeline de 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 de um envio.

Tipos enumerados
STATE_UNSPECIFIED Nenhum estado especificado. Isso nunca deve ser retornado.
CREATED A inscrição foi criada.
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 enviou o documento atribuído e depois escolheu "cancelar o envio", a ele o controle novamente como proprietário.
STUDENT_EDITED_AFTER_TURN_IN O estudante editou o trabalho depois de entregar. No momento, usado apenas em "Perguntas" quando o estudante edita a resposta.

GradeHistory

O histórico de cada nota nessa atividade.

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

number

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

number

O denominador da nota neste momento no 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 neste momento no histórico de notas do envio.

GradeChangeType

Possíveis tipos de mudança de nota.

Tipos enumerados
UNKNOWN_GRADE_CHANGE_TYPE Nenhum tipo de mudança de nota especificado. Isso nunca deve ser retornado.
DRAFT_GRADE_POINTS_EARNED_CHANGE Uma mudança no numerador da nota provisória.
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 um envio de estudante.

list

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

modifyAttachments

 Modifica os anexos do envio do estudante.

patch

 Atualiza um ou mais campos de uma atividade enviada por um estudante.

reclaim

 Recupera um envio de estudante em nome do estudante proprietário.

return

 Retorna um envio de estudante.

turnIn

 Entrega o envio de um estudante.