REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Envio do estudante para o trabalho do curso.

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

Os envios dos estudantes que nunca foram acessados (por exemplo, com state = NOVO) 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),

  // 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 a que ele corresponde.

Somente leitura.

id

string

Identificador atribuído pelo Google Sala de Aula para o envio do estudante. Esse número é diferente entre os envios para o trabalho relevante do curso.

Somente leitura.

userId

string

Identificador do estudante que é o proprietário deste envio.

Somente leitura.

creationTime

string (Timestamp format)

Horário de criação deste envio. Esta opção não será definida se o aluno não tiver acessado este item.

Somente leitura.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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. Esta opção não será definida se o aluno não tiver acessado este item.

Somente leitura.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 o envio está atrasado.

Somente leitura.

draftGrade

number

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

Ela só pode ser vista pelos professores dos cursos e pode ser modificada por eles.

assignedGrade

number

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

Apenas os professores do curso podem fazer alterações.

rubricId

string

Apenas saída. Identificador da rubrica atualmente anexada ao trabalho do curso e usado para avaliar o envio deste estudante.

Esse ID ficará vazio se não houver rubrica. Esse ID reflete a rubrica ativa no momento e será alterado se os professores excluírem e recriarem a rubrica.

Somente leitura.

draftRubricGrades

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

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

Este mapa vai ficar vazio se não houver rubricas anexadas 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" }.

assignedRubricGrades

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

Notas atribuídas pela rubrica com base nos critérios dela.

Este mapa vai ficar vazio se não houver rubricas anexadas 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 relacionado a este envio.

Somente leitura.

associatedWithDeveloper

boolean

Se este envio de estudante está associado ao projeto do Play Console que fez a solicitação.

Consulte courseWork.create para mais detalhes.

Somente leitura.

submissionHistory[]

object (SubmissionHistory)

o histórico do envio, incluindo 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 os novos recursos da API disponibilizados aos 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 do envio quando o titleWorkType é ASSIGNMENT.

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

shortAnswerSubmission

object (ShortAnswerSubmission)

Conteúdo do envio quando o titleWorkType é SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Conteúdo do envio quando o titleWorkType é 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 a esse critério, normalmente com base no nível. Os níveis podem ou não ter pontos. Se ela não for definida, 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. É possível que os arquivos do Google Drive que correspondam aos materiais com o modo de compartilhamento STUDENT_COPY 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 acessá-los. Os campos "Identifier" e "alternateLink" estão sempre disponíveis, mas outros (por exemplo, title) podem não estar.

Conexão

Anexo adicionado aos trabalhos dos estudantes.

Ao criar anexos, não é possível configurar 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 app Formulários Google.

ShortAnswerSubmission

Trabalho do estudante em 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 em 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 estados e séries.

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 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 este envio esteve.

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

enum (State)

Fase do pipeline do fluxo de trabalho.

stateTimestamp

string (Timestamp format)

Quando o envio entrou nesse estado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 de um envio.

Enums
STATE_UNSPECIFIED Nenhum estado especificado. Essa informação nunca deve ser retornada.
CREATED O envio foi criado.
TURNED_IN O aluno entregou um documento atribuído, que pode ou não ser um modelo.
RETURNED O professor devolveu o documento atribuído para o estudante.
RECLAIMED_BY_STUDENT O estudante entregou o documento atribuído e decidiu "cancelar o envio" para que ele possa voltar a ter controle sobre o processo.
STUDENT_EDITED_AFTER_TURN_IN O estudante editou o envio após entregá-lo. No momento, esse recurso só é usado no recurso Perguntas quando o estudante edita a própria resposta.

GradeHistory

O histórico de cada nota desta 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 de envio.

maxPoints

number

O denominador da nota neste momento no histórico de notas de envios.

gradeTimestamp

string (Timestamp format)

a data em que a nota da atividade foi alterada.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 alteração da nota;

gradeChangeType

enum (GradeChangeType)

É o tipo de alteração de nota no momento no histórico de notas enviadas.

GradeChangeType

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

Enums
UNKNOWN_GRADE_CHANGE_TYPE Nenhum tipo de alteração de nota especificado. Essa informação nunca deve ser retornada.
DRAFT_GRADE_POINTS_EARNED_CHANGE Uma alteração no numerador da nota temporária.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Uma alteração no numerador da nota atribuída.
MAX_POINTS_CHANGE Uma alteração no denominador da nota.

Métodos

get

Retorna o envio de um estudante.

list

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

modifyAttachments

Modifica os anexos enviados pelos estudantes.

patch

Atualiza um ou mais campos dos envios de um estudante.

reclaim

Recupera um envio de estudante em nome do estudante que o detém.

return

Retorna o envio de um estudante.

turnIn

entrega o envio de um estudante;