REST Resource: courses.courseWork.studentSubmissions

Risorsa: Invio dello studente

Invio dello studente per il lavoro del corso.

Vengono generati StudentSubmission elementi quando viene creato un elemento CourseWork.

I compiti degli studenti che non sono mai stati consultati (ad esempio con state = NUOVO) 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

Identificatore del corso.

Sola lettura.

courseWorkId

string

L'identificatore del lavoro del corso a cui corrisponde.

Sola lettura.

id

string

Identificatore assegnato in Classroom per l'invio dallo studente. Si tratta di un'opzione unica tra i contenuti inviati per il lavoro pertinente del corso.

Sola lettura.

userId

string

Identificatore dello studente proprietario di questo invio.

Sola lettura.

creationTime

string (Timestamp format)

Data/ora di creazione dell'invio. L'impostazione potrebbe non essere impostata se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, 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 dell'invio. L'impostazione potrebbe non essere impostata se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, 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 dell'invio.

Sola lettura.

late

boolean

Indica se l'invio è in ritardo.

Sola lettura.

draftGrade

number

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

Questa informazione è visibile e modificabile solo per gli insegnanti del corso.

assignedGrade

number

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

Questa opzione può essere modificata solo dagli insegnanti del corso.

rubricId

string

Solo output. Identificatore della griglia attualmente allegata al lavoro di questo corso e utilizzato per valutare i contenuti inviati dallo studente.

Questo ID è vuoto se non è presente una 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))

Voti della griglia in sospeso in base ai criteri della griglia stessa.

La mappa è vuota se non ci sono griglie associate a questo lavoro del corso o se è allegata una griglia, ma non è stato assegnato alcun voto in base a alcun 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))

Voti assegnati alla griglia in base ai criteri della griglia.

La mappa è vuota se non ci sono griglie associate a questo lavoro del corso o se è allegata una griglia, ma non è stato assegnato alcun voto in base a 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 si riferisce l'invio.

Sola lettura.

associatedWithDeveloper

boolean

Indica se l'invio dello studente è associato al progetto della Console per gli sviluppatori che ha effettuato la richiesta.

Per ulteriori dettagli, visita la pagina courseWork.create.

Sola lettura.

submissionHistory[]

object (SubmissionHistory)

La cronologia dei contenuti inviati (incluse le cronologie relative agli stati e ai voti).

Sola lettura.

previewVersion

enum (PreviewVersion)

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

Campo di 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 il valore del campo CourseWorkType è SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenuti dell'invio quando il valore del campo CourseWorkType è MULTIPLE_CHOICE_QUESTION.

RubricGrade

Un voto in una 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

Campo facoltativo. ID criterio.

levelId

string

Campo facoltativo. ID facoltativo del livello selezionato. Se vuoto, non è stato selezionato nessun livello.

points

number

Campo facoltativo. Punti facoltativi assegnati per questo criterio, in genere in base al livello. I livelli possono avere o meno dei punti. Se il criterio non viene configurato, non è stato impostato alcun punto 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 di STUDENT_COPY potrebbero non esistere 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 Identificatore e alternateLink sono sempre disponibili, ma altri (ad esempio, title) potrebbero non esserlo.

Legame

Allegato aggiunto al lavoro del compito dello studente.

Durante la creazione di 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 di 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

Lavoro dello studente per una domanda a scelta multipla.

Rappresentazione JSON
{
  "answer": string
}
Campi
answer

string

Scelto dallo studente.

SubmissionHistory

La cronologia dei contenuti inviati. Attualmente sono incluse le cronologie relative agli stati e ai 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 di unione type. Tipo di SubmissionHistory. Può essere uno dei valori 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 dei compiti 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)

Fase della pipeline del flusso di lavoro.

stateTimestamp

string (Timestamp format)

Lo stato dei contenuti inviati.

Un timestamp in formato "Zulu" UTC RFC3339, 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

Possibili stati di un invio.

Enum
STATE_UNSPECIFIED Nessuno stato specificato. Questo non deve mai essere restituito.
CREATED I contenuti inviati sono stati creati.
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 la consegna" del compito, concedendo di nuovo allo studente il controllo come proprietario.
STUDENT_EDITED_AFTER_TURN_IN Lo studente ha modificato i contenuti inviati dopo la consegna. Attualmente, viene utilizzato solo dalle domande, quando lo studente modifica la propria risposta.

GradeHistory

La cronologia di ogni voto relativo a questo invio.

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

number

Il numeratore del voto al momento nella cronologia dei voti di invio.

maxPoints

number

La denominatore del voto in questo momento nella cronologia dei voti di invio.

gradeTimestamp

string (Timestamp format)

Quando il voto dei contenuti inviati è stato modificato.

Un timestamp in formato "Zulu" UTC RFC3339, 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 al voto.

gradeChangeType

enum (GradeChangeType)

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

GradeChangeType

Possibili tipi di modifica del voto.

Enum
UNKNOWN_GRADE_CHANGE_TYPE Nessun tipo di modifica del voto specificato. Questo non deve mai essere restituito.
DRAFT_GRADE_POINTS_EARNED_CHANGE Una modifica nel numeratore del voto provvisorio.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Una modifica nel numeratore del voto assegnato.
MAX_POINTS_CHANGE Una modifica della denominatore del voto.

Metodi

get

Restituisce il compito inviato da uno studente.

list

Restituisce un elenco dei contenuti inviati dagli studenti che il richiedente è autorizzato a 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

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

return

Restituisce il compito inviato da uno studente.

turnIn

Consegna il lavoro inviato da uno studente.