REST Resource: courses.courseWork.studentSubmissions

Risorsa: invio dello studente

Contenuti inviati dallo studente per il lavoro del corso.

StudentSubmission elementi vengono generati quando viene creato un elemento CourseWork.

I compiti degli studenti a cui non è mai stato eseguito l'accesso (ad esempio con state = NUOVO) potrebbero non avere un'ora di creazione o un 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

Identificatore del corso.

Sola lettura.

courseWorkId

string

Identificatore del lavoro del corso a cui corrisponde.

Sola lettura.

id

string

Identificatore assegnato da Classroom ai contenuti inviati dallo studente. Si tratta di un metodo unico tra i contenuti inviati per il lavoro pertinente del corso.

Sola lettura.

userId

string

Identificatore dello studente proprietario dei contenuti inviati.

Sola lettura.

creationTime

string (Timestamp format)

Data/ora di creazione dei contenuti inviati. Questa opzione potrebbe non essere impostata se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Data/ora ultimo aggiornamento di questo invio. Questa opzione potrebbe non essere impostata se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (SubmissionState)

Stato dei contenuti inviati.

Sola lettura.

late

boolean

Indica se l'invio è in ritardo.

Sola lettura.

draftGrade

number

Voto in attesa facoltativo. Se il criterio non viene configurato, 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.

Questa opzione è visibile e modificabile solo dagli insegnanti del corso.

assignedGrade

number

Voto facoltativo. Se il criterio non viene configurato, 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 lavoro del corso e utilizzata per valutare i contenuti inviati dallo studente.

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

Sola lettura.

draftRubricGrades

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

I voti delle griglie sono in attesa in base ai criteri della griglia.

Questa mappa è vuota se a questo lavoro del corso non è allegata alcuna griglia 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 griglia.

Sola lettura.

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

assignedRubricGrades

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

I voti della griglia sono stati assegnati in base ai Criteri della griglia.

Questa mappa è vuota se a questo lavoro del corso non è allegata alcuna griglia 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 griglia.

Sola lettura.

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

courseWorkType

enum (CourseWorkType)

Il tipo di lavoro del corso a cui è destinato l'invio.

Sola lettura.

associatedWithDeveloper

boolean

Se l'invio dello studente è associato al progetto della Developer Console che ha effettuato la richiesta.

Per maggiori dettagli, visita la pagina courseWork.create.

Sola lettura.

submissionHistory[]

object (SubmissionHistory)

La cronologia dei contenuti inviati (incluse le cronologie statali e dei voti).

Sola lettura.

previewVersion

enum (PreviewVersion)

Solo output. La versione di anteprima dell'API. Questa impostazione deve essere impostata per accedere alle nuove funzionalità dell'API messe a disposizione degli sviluppatori nel Programma Anteprima.

Campo unione content. Contenuti inviati. Il tipo specifico dipende dal valore dell'elemento course_work_type. content può essere solo uno dei seguenti:
assignmentSubmission

object (AssignmentSubmission)

Contenuti da inviare quando il campo CourseWorkType è ASSIGNMENT.

Gli studenti possono modificare questi contenuti utilizzando studentSubmissions.modifyAttachments.

shortAnswerSubmission

object (ShortAnswerSubmission)

Invia contenuti quando il campo CourseWorkType è SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

I contenuti vengono inviati quando il valore del campo CourseWorkType è MULTIPLE_CHOICE_QUESTION.

RubricGrade

Un voto in griglia impostato per l'invio dello studente. Esiste 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 vuoto, non è stato selezionato alcun livello.

points

number

(Facoltativo) Punti facoltativi assegnati a questo criterio, di solito in base al livello. I livelli potrebbero avere o meno punti. Se il criterio non viene configurato, non è stato impostato alcun punto 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 che corrispondono a materiali con una modalità di condivisione di 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 ha inviato la richiesta dispone dell'autorizzazione per accedervi. I campi Identifier e alternateLink sono sempre disponibili, mentre altri campi (ad esempio title) potrebbero non esserlo.

Allegato

Allegato aggiunto al lavoro del compito dello studente.

Quando si creano 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 file di Google Drive.

youTubeVideo

object (YouTubeVideo)

Allegato video di YouTube.

form

object (Form)

Allegato di Moduli Google.

ShortAnswerSubmission

Lo studente lavora 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 scelta dallo studente.

SubmissionHistory

La cronologia dei contenuti inviati. Al momento sono incluse le cronologie degli stati e dei voti.

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. Type of SubmissionHistory, può essere StateHistory, GradeHistory. type può essere solo uno dei seguenti:
stateHistory

object (StateHistory)

Le informazioni sulla cronologia dello stato dei contenuti inviati, se presenti.

gradeHistory

object (GradeHistory)

Le informazioni sulla cronologia dei voti dei contenuti inviati, se presenti.

StateHistory

La cronologia di ogni stato in cui si trovava l'invio.

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

enum (State)

La fase della pipeline del flusso di lavoro.

stateTimestamp

string (Timestamp format)

Quando i contenuti inviati sono entrati in questo stato.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

actorUserId

string

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

Stato

Stati possibili in cui si trova un invio.

Enum
STATE_UNSPECIFIED Nessuno stato specificato. Questo valore non deve mai essere restituito.
CREATED Il Contributo è stato creato.
TURNED_IN Lo studente ha consegnato un documento assegnato, che può 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 "annullare l'invio" il compito, assegnando nuovamente allo studente il controllo come proprietario.
STUDENT_EDITED_AFTER_TURN_IN Lo studente ha modificato i contenuti inviati dopo averli consegnati. Attualmente, questa opzione viene utilizzata solo dalle domande, quando lo studente modifica la 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 inviati.

maxPoints

number

Il denominatore del voto in questo momento nella cronologia dei voti inviati.

gradeTimestamp

string (Timestamp format)

Quando il voto dei contenuti inviati è stato modificato.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

actorUserId

string

L'insegnante che ha apportato la modifica.

gradeChangeType

enum (GradeChangeType)

Il tipo di voto cambia in questo momento nella cronologia dei voti inviati.

GradeChangeType

Possibili tipi di modifica dei voti.

Enum
UNKNOWN_GRADE_CHANGE_TYPE Nessun tipo di modifica del voto specificato. Questo valore non deve mai essere restituito.
DRAFT_GRADE_POINTS_EARNED_CHANGE Una modifica al numeratore del voto provvisorio.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Una modifica al 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 contenuti inviati dagli studenti che il richiedente può visualizzare, tenendo conto degli ambiti OAuth della richiesta.

modifyAttachments

Modifica gli allegati dei contenuti inviati dagli studenti.

patch

Consente di aggiornare uno o più campi dei contenuti inviati da 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.