REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Trabalho enviado pelos estudantes.

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

Os envios dos estudantes que nunca foram acessados (ou seja, com state = NEW) não têm uma hora 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),

  // 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 do trabalho do curso correspondente.

Somente leitura.
id

string

Identificador atribuído pelo Google Sala de Aula para o envio do estudante. Esse é um caso único entre os envios para o trabalho relevante do curso.

Somente leitura.
userId

string

Identificador do aluno proprietário deste envio.

Somente leitura.
creationTime

string (Timestamp format)

Hora de criação deste envio. Essa opção pode ser desmarcada 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)

Hora da última atualização deste envio. Essa opção pode ser desmarcada 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 deste envio.

Somente leitura.
late

boolean

Indica se este envio está atrasado.

Somente leitura.
draftGrade

number

Nota pendente opcional. Se ela for deixada sem definição, 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.

Esse recurso só pode ser visto e modificado pelos professores.
assignedGrade

number

Nota opcional. Se ela for deixada sem definição, 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 pode ser modificado apenas pelos professores do curso.
rubricId

string

Apenas saída. Identificador da rubrica atualmente anexada a este trabalho do curso e usada para avaliar o envio do aluno.

Esse código ficará em branco se não houver uma rubrica. Esse ID reflete a rubrica ativa no momento. mas ela muda quando os professores excluem e recriam a rubrica.

Somente leitura.

draftRubricGrades

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

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

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

Este mapa ficará vazio se não houver uma rubrica anexada ao trabalho do curso ou se uma rubrica estiver anexada, mas nenhuma nota tiver sido definida nos critérios. As entradas só são preenchidas 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 ao qual este envio se destina.

Somente leitura.
associatedWithDeveloper

boolean

Indica se este 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óricos de estado e de notas).

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. A versão de pré-lançamento da API. Isso precisa ser definido para acessar as novas funcionalidades da API disponibilizadas para os desenvolvedores no Programa de testes.
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 enviado quando "courseWorkType" for ASSIGNMENT.

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

object (ShortAnswerSubmission)

Conteúdo enviado quando CourseWorkType for SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Conteúdo do envio quando CourseWorkType for MULTIPLE_CHOICE_QUESTION.

RubricGrade

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

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

string

Opcional. ID de critério.
levelId

string

Opcional. ID de nível 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 foi definido para esse critério.

AssignmentSubmission

Trabalho do estudante em uma atividade.

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

object (Attachment)

Anexos adicionados pelo estudante. Talvez os arquivos do Google Drive que correspondam aos materiais com o modo de compartilhamento STUDENT_COPY ainda não existam se o aluno não tiver acessado a tarefa no Google Sala de Aula.

Alguns metadados de anexos só serã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") talvez não estejam.

Anexo

Anexo adicionado ao trabalho do estudante na atividade.

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 estudante para uma pergunta de resposta curta.

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

string

Resposta do estudante a uma pergunta de resposta curta.

MultipleChoiceSubmission

Trabalhos dos estudantes em uma pergunta de múltipla escolha.

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

string

Escolha selecionada pelo estudante.

SubmissionHistory

O histórico do envio. No momento, isso inclui 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. O tipo de SubmissionHistory pode ser StateHistory, 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 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 alteração.

Estado

Estados possíveis para um envio.

Enums
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 A professora devolveu o documento atribuído ao aluno.
RECLAIMED_BY_STUDENT O estudante entregou o documento atribuído e escolheu "cancelar o envio". a atividade, concedendo ao aluno o controle novamente como proprietário.
STUDENT_EDITED_AFTER_TURN_IN O estudante editou o trabalho depois de entregá-lo. No momento, esta opção é usada apenas pelas 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 momento, no histórico de notas de envios.
maxPoints

number

O denominador da nota nesse momento no histórico de notas de envios.
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 alterou a nota;
gradeChangeType

enum (GradeChangeType)

O tipo de alteração na nota no momento no histórico de notas de envios.

GradeChangeType

Possíveis tipos de alteração de notas.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Nenhum tipo de alteração de nota especificado. Isso nunca deve ser retornado.
DRAFT_GRADE_POINTS_EARNED_CHANGE Uma mudança no numerador da nota temporá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 o envio de um estudante.

list

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

modifyAttachments

 Modifica os anexos enviados pelo estudante.

patch

 Atualiza um ou mais campos do envio de um estudante.

reclaim

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

return

 Retorna o envio de um estudante.

turnIn

 Entrega o trabalho de um estudante.