REST Resource: courses.courseWork.studentSubmissions

Risorsa: StudentSubmission

Contenuti inviati dagli studenti per l'attività del corso.

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

Gli invii degli studenti a cui non è mai stato eseguito l'accesso (ovvero con state = NEW) potrebbero non avere un orario 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),

  // 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.
}
Campi
courseId

string

L'identificatore del corso.

Sola lettura.
courseWorkId

string

Identificatore del lavoro del corso a cui corrisponde.

Sola lettura.
id

string

Identificatore assegnato da Classroom per l'invio dello studente. Questo valore è univoco tra gli invii per il lavoro del corso pertinente.

Sola lettura.
userId

string

Identificatore dello studente proprietario di questo invio.

Sola lettura.
creationTime

string (Timestamp format)

Ora di creazione di questo invio. Questo valore 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 normalizzato in base al fuso orario UTC 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 ultimo aggiornamento di questo invio. Questo valore 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 normalizzato in base al fuso orario UTC 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)

Lo 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. Sono consentiti valori decimali (ovvero non interi), ma vengono arrotondati a due cifre decimali.

Questi dati sono visibili e modificabili 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. Sono consentiti valori decimali (ovvero non interi), ma vengono arrotondati a due cifre decimali.

Questa impostazione può essere modificata solo dagli insegnanti del corso.
rubricId

string

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

Questo ID è vuoto se non è presente alcun criterio. Questo ID riflette la rubrica attualmente attiva e cambia se gli insegnanti la eliminano e la ricreano.

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 è allegata alcuna griglia a questo compito o se è allegata 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 rubrica.

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 della griglia assegnati in base ai criteri della griglia.

Questa mappa è vuota se non è allegata alcuna griglia a questo compito o se è allegata 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 rubrica.

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 a cui si riferisce l'invio.

Sola lettura.
associatedWithDeveloper

boolean

Se l'invio di questo studente è associato al progetto della console per gli sviluppatori che effettua la richiesta.

Per maggiori dettagli, consulta courseWork.create.

Sola lettura.
submissionHistory[]

object (SubmissionHistory)

La cronologia dell'invio (include la cronologia dello stato 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à API rese disponibili agli sviluppatori nel programma di anteprima.
Campo unione content. Contenuti inviati. Il tipo specifico dipende dal valore di course_work_type. content può essere solo uno dei seguenti:
assignmentSubmission

object (AssignmentSubmission)

Contenuti dell'invio quando courseWorkType è ASSIGNMENT.

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

object (ShortAnswerSubmission)

Contenuti dell'invio quando courseWorkType è SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenuti dell'invio quando courseWorkType è MULTIPLE_CHOICE_QUESTION.

RubricGrade

Un voto della griglia impostato per i contenuti inviati dallo studente. Esiste al massimo una voce per ogni criterio della griglia di valutazione.

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

string

(Facoltativo) ID criterio.
levelId

string

(Facoltativo) ID livello facoltativo del livello selezionato. Se è vuoto, non è stato selezionato alcun livello.
points

number

(Facoltativo) Punti facoltativi assegnati per questo criterio, in genere in base al livello. I livelli possono avere punti o meno. Se non è impostato, non sono stati assegnati punti per questo criterio.

AssignmentSubmission

Il lavoro di uno studente per un compito.

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

object (Attachment)

Allegati aggiunti dallo studente. I file di Drive corrispondenti ai materiali con 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 che effettua la richiesta ha l'autorizzazione per accedervi. I campi Identifier e alternateLink sono sempre disponibili, ma altri (ad esempio, title) potrebbero non esserlo.

Allegato

Allegato aggiunto al lavoro del compito dello studente.

Quando crei allegati, l'impostazione del campo form non è supportata.

Rappresentazione 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.
}
Campi
Campo unione attachment. Dati degli allegati. attachment può essere solo uno dei seguenti:
driveFile

object (DriveFile)

Allegato di file di Google Drive.
youTubeVideo

object (YouTubeVideo)

Allegato video di YouTube.
form

object (Form)

Allegato di Moduli Google.

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

Il lavoro dello studente per una domanda a scelta multipla.

Rappresentazione JSON 
{
  "answer": string
}
Campi
answer

string

Scelta dello studente.

SubmissionHistory

La cronologia dell'invio. Al momento sono incluse le cronologie di stato e grado.

Rappresentazione 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.
}
Campi
Campo unione type. Tipo di SubmissionHistory, può essere StateHistory o GradeHistory. type può essere solo uno dei seguenti:
stateHistory

object (StateHistory)

Le informazioni sulla cronologia dello stato dell'invio, se presenti.
gradeHistory

object (GradeHistory)

Le informazioni sulla cronologia dei voti dell'invio, se presenti.

StateHistory

La cronologia di ogni stato in cui si trova l'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 normalizzato in base al fuso orario UTC 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

Stati possibili di un invio.

Enum
STATE_UNSPECIFIED Nessuno stato specificato. Questo valore non dovrebbe mai essere restituito.
CREATED L'invio è stato creato.
TURNED_IN Lo studente ha consegnato un documento assegnato, che può essere o meno un modello.
RETURNED L'insegnante ha restituito allo studente il documento assegnato.
RECLAIMED_BY_STUDENT Lo studente ha consegnato il documento assegnato, poi ha scelto di "annullare l'invio" del compito, riacquisendo il controllo come proprietario.
STUDENT_EDITED_AFTER_TURN_IN Lo studente ha modificato il compito inviato. Attualmente, viene utilizzato solo in Domande, quando lo studente modifica la sua risposta.

GradeHistory

La cronologia di ogni voto di questo invio.

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 dell'invio.
maxPoints

number

Il denominatore del voto in questo momento nella cronologia dei voti dell'invio.
gradeTimestamp

string (Timestamp format)

Quando il voto dell'invio è stato modificato.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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 apportato la modifica del voto.
gradeChangeType

enum (GradeChangeType)

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

GradeChangeType

Tipi di modifiche ai voti possibili.

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

Metodi

get

 Restituisce i contenuti inviati da uno 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 dei contenuti inviati dagli studenti.

patch

 Aggiorna uno o più campi dell'invio di uno studente.

reclaim

 Recupera i contenuti inviati da uno studente per conto dello studente proprietario.

return

 Restituisce i contenuti inviati da uno studente.

turnIn

 Consegna i contenuti inviati da uno studente.