Seus usuários usam o Google Sala de Aula com o Google Meet? Confira o guia de início rápido do Apps Script que mostra como verificar a participação dos alunos nos cursos do Google Meet.

REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Trabalho enviado pelos alunos para o trabalho.

Os itens "StudentSubmission" são gerados quando um item do "WorkWork" é criado.

As inscrições de Student que nunca foram acessadas (por exemplo, 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,
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],

  // 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 ao envio do aluno. Eles são exclusivos entre os envios de trabalhos relevantes do curso.

Somente leitura.
userId

string

Identificador do aluno que é proprietário deste envio.

Somente leitura.
creationTime

string (Timestamp format)

Hora de criação deste envio. Essa configuração pode ser deixada sem definição se o aluno não tiver acessado o item.

Somente leitura.

Timestamp 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 configuração pode ser deixada sem definição se o aluno não tiver acessado o item.

Somente leitura.

Timestamp 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 não for definida, nenhuma nota será 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 vista e pode ser modificada pelos professores do curso.
assignedGrade

number

Nota opcional. Se não for definida, nenhuma nota será 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.
courseWorkType

enum (CourseWorkType)

É o tipo de trabalho do curso.

Somente leitura.
associatedWithDeveloper

boolean

Se esse envio de aluno está associado ao projeto do Play Console que está fazendo a solicitação.

Consulte courseWork.create para ver mais detalhes.

Somente leitura.
submissionHistory[]

object (SubmissionHistory)

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

Somente leitura.
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)

Envio de conteúdo quando o curso WorkWorkType é ASSIGNMENT.

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

object (ShortAnswerSubmission)

Envio de conteúdo quando o curso WorkWorkType é SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Envio de conteúdo quando o curso WorkWorkType é MULTIPLE_CHOICE_QUESTION.

SubmissionState

Possíveis estados dos arquivos enviados pelos alunos.

Enums
SUBMISSION_STATE_UNSPECIFIED Nenhum estado especificado. Este valor nunca deve ser retornado.
NEW O aluno nunca acessou este envio. Os anexos não são retornados e os carimbos de data/hora não são definidos.
CREATED Foi criada.
TURNED_IN foi entregue ao professor.
RETURNED foi devolvido para o aluno;
RECLAIMED_BY_STUDENT O aluno escolheu "cancelar envio" a atividade.

Atribuição

trabalhos dos alunos em uma atividade

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

object (Attachment)

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

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

Anexo

O anexo foi adicionado aos trabalhos dos trabalhos dos alunos.

Ao criar anexos, definir o campo form não é aceito.

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

trabalhos dos alunos para uma pergunta de resposta curta

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

string

Resposta do aluno a uma pergunta de resposta curta.

Envio múltiplo

Um trabalho do aluno para uma pergunta de múltipla escolha

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

string

Opção de seleção dos alunos.

SubmissionHistory

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

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, GradeHistory. type pode ser apenas de um dos tipos a seguir:
stateHistory

object (StateHistory)

O histórico de informações do envio, se presente.
gradeHistory

object (GradeHistory)

O histórico de notas do envio, se houver.

HistóricodeEstado

O histórico de cada estado em que este envio foi feito.

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.

Timestamp 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 aluno que fez a alteração.

Estado

São os estados possíveis para o envio.

Enums
STATE_UNSPECIFIED Nenhum estado especificado. Este valor nunca deve ser retornado.
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 ao aluno.
RECLAIMED_BY_STUDENT O aluno entregou o documento atribuído e escolheu "cancelar o envio" da atividade. Assim o aluno novamente tem a função de proprietário.
STUDENT_EDITED_AFTER_TURN_IN O aluno editou o arquivo enviado. Atualmente, usado apenas por perguntas, quando o aluno edita a própria resposta.

Histórico de notas

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 enviado.
maxPoints

number

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

string (Timestamp format)

Quando a nota do envio foi alterada.

Timestamp 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 nota.
gradeChangeType

enum (GradeChangeType)

O tipo de alteração das notas no momento no histórico de notas enviado.

TipoDeMudanças

Tipos de mudança de nota possíveis.

Enums
UNKNOWN_GRADE_CHANGE_TYPE Nenhum tipo de alteração de nota especificado. Este valor nunca deve ser retornado.
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 um arquivo enviado por um aluno.

list

 Retorna uma lista de arquivos enviados pelos alunos que o requerente pode ver, considerando os escopos do OAuth da solicitação.

modifyAttachments

 Modifica os anexos dos arquivos enviados pelos alunos.

patch

 Atualiza um ou mais campos do envio de um aluno.

reclaim

 Reivindique um arquivo enviado pelo aluno em nome dele.

return

 Retorna um arquivo enviado por um aluno.

turnIn

 entrega dos trabalhos enviados pelos alunos;