- Recurso: StudentSubmission
- RubricGrade
- AssignmentSubmission (link em inglês)
- Anexo
- ShortAnswerSubmission (em inglês)
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Estado
- GradeHistory
- GradeChangeType
- Métodos
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 ( |
Campos | |
---|---|
courseId |
Identificador do curso. Somente leitura. |
courseWorkId |
Identificador do trabalho do curso a que ele corresponde. Somente leitura. |
id |
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 |
Identificador do estudante que é o proprietário deste envio. Somente leitura. |
creationTime |
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: |
updateTime |
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: |
state |
Estado deste envio. Somente leitura. |
late |
Indica se o envio está atrasado. Somente leitura. |
draftGrade |
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 |
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 |
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 |
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 |
assignedRubricGrades |
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 |
alternateLink |
É o link absoluto para o envio na interface da Web do Google Sala de Aula. Somente leitura. |
courseWorkType |
Tipo de trabalho do curso relacionado a este envio. Somente leitura. |
associatedWithDeveloper |
Se este envio de estudante está associado ao projeto do Play Console que fez a solicitação. Consulte Somente leitura. |
submissionHistory[] |
o histórico do envio, incluindo históricos de estado e de notas; Somente leitura. |
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 |
Conteúdo do envio quando o titleWorkType é ASSIGNMENT. Os estudantes podem modificar esse conteúdo usando o |
shortAnswerSubmission |
Conteúdo do envio quando o titleWorkType é SHORT_ANSWER_QUESTION. |
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 |
Opcional. ID do critério. |
levelId |
Opcional. ID opcional do nível selecionado. Se estiver vazio, nenhum nível foi selecionado. |
points |
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 ( |
Campos | |
---|---|
attachments[] |
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 |
Campos | |
---|---|
Campo de união attachment . Dados do anexo. attachment pode ser apenas de um dos tipos a seguir: |
|
driveFile |
Anexo de arquivo do Google Drive. |
youTubeVideo |
Anexo de vídeo do YouTube. |
link |
Anexo do link. |
form |
Anexo do app Formulários Google. |
ShortAnswerSubmission
Trabalho do estudante em uma pergunta de resposta curta.
Representação JSON |
---|
{ "answer": string } |
Campos | |
---|---|
answer |
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 |
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 |
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 |
As informações do histórico de estado do envio, se houver. |
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 ( |
Campos | |
---|---|
state |
Fase do pipeline do fluxo de trabalho. |
stateTimestamp |
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: |
actorUserId |
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 ( |
Campos | |
---|---|
pointsEarned |
O numerador da nota, neste momento, no histórico de notas de envio. |
maxPoints |
O denominador da nota neste momento no histórico de notas de envios. |
gradeTimestamp |
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: |
actorUserId |
o professor que fez a alteração da nota; |
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 |
|
---|---|
|
Retorna o envio de um estudante. |
|
Retorna uma lista dos envios de estudantes que o solicitante tem permissão para ver, considerando os escopos do OAuth da solicitação. |
|
Modifica os anexos enviados pelos estudantes. |
|
Atualiza um ou mais campos dos envios de um estudante. |
|
Recupera um envio de estudante em nome do estudante que o detém. |
|
Retorna o envio de um estudante. |
|
entrega o envio de um estudante; |