REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Trabalho enviado por um estudante.

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

Os envios dos estudantes que nunca foram acessados (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 corresponde.

Somente leitura.
id

string

Identificador atribuído pelo Google Sala de Aula para o envio do estudante. Esse é um trabalho exclusivo para o curso.

Somente leitura.
userId

string

Identificador do aluno proprietário do envio.

Somente leitura.
creationTime

string (Timestamp format)

Hora de criação deste envio. Isso pode ser desativado se o estudante não tiver acessado o item.

Somente leitura.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Horário da última atualização deste envio. Isso pode ser desativado se o estudante não tiver acessado o item.

Somente leitura.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Estado do envio.

Somente leitura.
late

boolean

Se o envio está atrasado.

Somente leitura.
draftGrade

number

Nota pendente opcional. Se não for definido, 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.

Essa informação só pode ser modificada e acessada pelos professores do curso.
assignedGrade

number

Nota opcional. Se não for definido, 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.

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

string

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

Somente leitura.

draftRubricGrades

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

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

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 para 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))

As 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 uma rubrica estiver 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 destina.

Somente leitura.
associatedWithDeveloper

boolean

Se o envio do estudante está associado ao projeto do Play 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órico de estado e de nota).

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. 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.
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 da entrega quando courseWorkType é ASSIGNMENT.

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

object (ShortAnswerSubmission)

Conteúdo do envio quando courseWorkType é SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Conteúdo da submissão quando courseWorkType é MULTIPLE_CHOICE_QUESTION.

RubricGrade

Uma nota da rubrica definida para o envio do estudante. Há no máximo uma entrada por critério da 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 para 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 foi definido para esse critério.

AssignmentSubmission

Trabalho de um estudante para 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 ainda 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 à atividade do estudante.

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

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 do anexo. 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 do aluno para uma pergunta de resposta curta.

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

string

Resposta do 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. Isso inclui atualmente os históricos 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, 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)

Estágio do pipeline do fluxo de trabalho.
stateTimestamp

string (Timestamp format)

Quando o envio entrou nesse estado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
actorUserId

string

O professor ou estudante que fez a mudança.

Estado

Estados possíveis para um envio.

Enums
STATE_UNSPECIFIED Nenhum estado especificado. Isso nunca deve ser retornado.
CREATED A submissã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 entregou o documento atribuído e depois escolheu "cancelar o envio" da atividade, ao estudante o controle novamente como proprietário.
STUDENT_EDITED_AFTER_TURN_IN O aluno editou o envio depois de enviá-lo. Atualmente, é usado apenas por perguntas, quando o estudante edita a resposta.

GradeHistory

O histórico de cada nota neste envio.

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

number

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

number

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

string (Timestamp format)

Quando a nota do envio foi alterada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
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 do envio.

GradeChangeType

Possíveis tipos de mudança de nota.

Enums
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 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 um envio de um 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 um envio do estudante.

reclaim

 Recuperar um envio de um estudante em nome do aluno proprietário.

return

 Retorna um envio de um estudante.

turnIn

 Envia uma atividade.