REST Resource: courses.courseWork.studentSubmissions

Risorsa: StudentSubmission

Compito inviato dallo studente per il lavoro del corso.

Gli elementi StudentSubmission vengono generati quando viene creato un elemento CourseWork.

I compiti inviati dagli studenti a cui non è mai stato eseguito l'accesso (ovvero con state = NEW) potrebbero non avere un'ora di creazione o di aggiornamento.

Rappresentazione 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),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Campi
courseId

string

Identificatore del corso.

Sola lettura.
courseWorkId

string

Identificatore del lavoro del corso a cui corrisponde.

Sola lettura.
id

string

Identificatore assegnato da Classroom per il compito inviato dallo studente. Questo è univoco tra i compiti per il lavoro del corso pertinente.

Sola lettura.
userId

string

Identificatore dello studente proprietario di questo compito.

Sola lettura.
creationTime

string (Timestamp format)

Ora di creazione di questo suggerimento. Questo campo potrebbe non essere impostato se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Data/ora dell'ultimo aggiornamento di questo suggerimento. Questo campo potrebbe non essere impostato se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Stato di questo invio.

Sola lettura.
late

boolean

Se i contenuti sono stati inviati in ritardo.

Sola lettura.
draftGrade

number

Voto in attesa facoltativo. Se non è impostato, non è stato impostato alcun voto. Questo valore non deve essere un numero negativo. I valori decimali (ovvero non interi) sono consentiti, ma vengono arrotondati a due cifre decimali.

Questo è visibile e modificabile solo dagli insegnanti del corso.
assignedGrade

number

Voto facoltativo. Se non è impostato, non è stato impostato alcun voto. Questo valore non deve essere un numero negativo. I valori decimali (ovvero non interi) sono consentiti, ma vengono arrotondati a due cifre decimali.

Può essere modificato solo dagli insegnanti del corso.
rubricId

string

Solo output. Identificatore della griglia attualmente allegata a questo compito e utilizzata per valutare questo compito dello studente.

Questo ID è vuoto se non è presente una griglia. Questo ID riflette la griglia attualmente attiva e cambia se gli insegnanti eliminano e ricreano la griglia.

Sola lettura.

draftRubricGrades

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

Voti della griglia in attesa in base ai criteri della griglia.

Questa mappa è vuota se non è presente una griglia allegata a questo compito o se è presente una griglia, ma non sono stati impostati voti per nessun criterio. Le voci vengono compilate solo per i voti impostati. Chiave: l'ID criterio della griglia.

Sola lettura.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

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

Voti assegnati in base ai criteri della griglia.

Questa mappa è vuota se non è presente una griglia allegata a questo compito o se è presente una griglia, ma non sono stati impostati voti per i criteri. Le voci vengono compilate solo per i voti impostati. Chiave: l'ID criterio della griglia.

Sola lettura.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Il tipo di lavoro del corso per cui viene inviato questo compito.

Sola lettura.
associatedWithDeveloper

boolean

Indica se questo compito dello studente è associato al progetto della Developer Console che effettua la richiesta.

Consulta courseWork.create per ulteriori dettagli.

Sola lettura.
submissionHistory[]

object (SubmissionHistory)

La cronologia dell'invio (include le cronologie degli stati e dei voti).

Sola lettura.
previewVersion

enum (PreviewVersion)

Solo output. La versione di anteprima dell'API. Questo valore deve essere impostato per accedere alle nuove funzionalità dell'API messe a disposizione degli sviluppatori nel programma Anteprima.
Contenuti da inviare. Il tipo specifico dipende dal valore di course_work_type. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
assignmentSubmission

object (AssignmentSubmission)

Contenuti del compito quando courseWorkType è ASSIGNMENT.

Gli studenti possono modificare questi contenuti utilizzando studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Contenuto del compito quando courseWorkType è SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenuto del compito consegnato quando courseWorkType è MULTIPLE_CHOICE_QUESTION.
Fine dei campi che si escludono a vicenda.

RubricGrade

Un voto della griglia impostato per il compito inviato dallo studente. È presente al massimo una voce per criterio della griglia.

Rappresentazione JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Campi
criterionId

string

Facoltativo. ID criterio.
levelId

string

Facoltativo. ID livello facoltativo del livello selezionato. Se il campo è vuoto, non è stato selezionato alcun livello.
points

number

Facoltativo. Punti facoltativi assegnati per questo criterio, in genere in base al livello. I livelli potrebbero avere o meno dei punti. Se non viene impostato, non sono stati impostati punti per questo criterio.

AssignmentSubmission

Lavoro dello studente per un compito.

Rappresentazione JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Campi
attachments[]

object (Attachment)

Allegati aggiunti dallo studente. I file di Drive che corrispondono ai materiali con una modalità di condivisione STUDENT_COPY potrebbero non esistere ancora se lo studente non ha eseguito l'accesso al compito in Classroom.

Alcuni metadati degli allegati vengono compilati solo se l'utente richiedente dispone dell'autorizzazione per accedervi. I campi identifier e alternateLink sono sempre disponibili, ma altri (ad esempio title) potrebbero non esserlo.

Allegato

Allegato aggiunto al lavoro assegnato dello studente.

Durante la creazione degli allegati, l'impostazione del campo form non è supportata.

Rappresentazione JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Campi
Dati degli allegati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
driveFile

object (DriveFile)

File di Google Drive allegato.
youTubeVideo

object (YouTubeVideo)

Allegato video di YouTube.
form

object (Form)

Allegato di Moduli Google.
Fine dei campi che si escludono a vicenda.

ShortAnswerSubmission

Lavoro dello studente per una domanda a risposta breve.

Rappresentazione JSON 
{
  "answer": string
}
Campi
answer

string

Risposta dello studente a una domanda a risposta breve.

MultipleChoiceSubmission

Lavoro dello studente per una domanda a scelta multipla.

Rappresentazione JSON 
{
  "answer": string
}
Campi
answer

string

Scelta selezionata dallo studente.

SubmissionHistory

La cronologia dell'invio. Al momento sono incluse le cronologie degli stati e dei voti.

Rappresentazione JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Campi
Tipo di SubmissionHistory, può essere uno tra StateHistory, GradeHistory. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
stateHistory

object (StateHistory)

Le informazioni sulla cronologia degli stati dell'invio, se presenti.
gradeHistory

object (GradeHistory)

Le informazioni sulla cronologia dei voti del compito, se presenti.
Fine dei campi che si escludono a vicenda.

StateHistory

La cronologia di ogni stato in cui si è trovato questo invio.

Rappresentazione JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Campi
state

enum (State)

La fase della pipeline del workflow.
stateTimestamp

string (Timestamp format)

Quando l'invio è entrato in questo stato.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
actorUserId

string

L'insegnante o lo studente che ha apportato la modifica.

Stato

Possibili stati di un compito.

Enum
STATE_UNSPECIFIED Nessuno stato specificato. Questo non dovrebbe mai essere restituito.
CREATED La richiesta è stata creata.
TURNED_IN Lo studente ha consegnato un documento assegnato, che potrebbe essere o meno un modello.
RETURNED L'insegnante ha restituito il documento assegnato allo studente.
RECLAIMED_BY_STUDENT Lo studente ha consegnato il documento assegnato e poi ha scelto di "ritirare" il compito, riprendendo il controllo come proprietario.
STUDENT_EDITED_AFTER_TURN_IN Lo studente ha modificato il compito dopo averlo consegnato. Attualmente, viene utilizzato solo da Domande, quando lo studente modifica la propria risposta.

GradeHistory

La cronologia di ogni voto di questo compito.

Rappresentazione JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Campi
pointsEarned

number

Il numeratore del voto in questo momento nella cronologia dei voti del compito inviato.
maxPoints

number

Il denominatore del voto in questo momento nella cronologia dei voti del compito inviato.
gradeTimestamp

string (Timestamp format)

Quando il voto del compito è stato modificato.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
actorUserId

string

L'insegnante che ha modificato il voto.
gradeChangeType

enum (GradeChangeType)

Il tipo di modifica del voto in questo momento nella cronologia dei voti del compito.

GradeChangeType

Possibili tipi di modifica del voto.

Enum
UNKNOWN_GRADE_CHANGE_TYPE Nessun tipo di modifica del voto specificato. Questo non dovrebbe mai essere restituito.
DRAFT_GRADE_POINTS_EARNED_CHANGE Una modifica al numeratore del voto della bozza.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Una modifica al numeratore del voto assegnato.
MAX_POINTS_CHANGE Una modifica del denominatore del voto.

Metodi

get

 Restituisce un compito dello studente.

list

 Restituisce un elenco dei compiti degli studenti che il richiedente è autorizzato a visualizzare, tenendo conto degli ambiti OAuth della richiesta.

modifyAttachments

 Modifica gli allegati del compito inviato dallo studente.

patch

 Aggiorna uno o più campi di un compito inviato da uno studente.

reclaim

 Recupera un compito inviato da uno studente per conto dello studente che lo possiede.

return

 Restituisce un compito dello studente.

turnIn

 Consegna un lavoro inviato da uno studente.