REST Resource: courses.courseWork.studentSubmissions

Risorsa: StudentSubmission

Invio di lavori da parte degli studenti.

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

I contenuti inviati dagli studenti a cui non è mai stato eseguito l'accesso (ovvero con state = NUOVO) potrebbero non avere una data di creazione o 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 compito del corso a cui corrisponde.

Sola lettura.
id

string

Identificatore assegnato da Classroom per l'invio dello studente. Deve essere univoco tra i lavori inviati 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.

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

string (Timestamp format)

Ora dell'ultimo aggiornamento di questo invio. Questo valore potrebbe non essere impostato se lo studente non ha eseguito l'accesso a questo elemento.

Sola lettura.

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

enum (SubmissionState)

Stato di questo invio.

Sola lettura.
late

boolean

Se i contenuti sono stati inviati in ritardo.

Sola lettura.
draftGrade

number

Voto facoltativo in attesa. 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 valore è 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.

Questo valore può essere modificato solo dagli insegnanti del corso.
rubricId

string

Solo output. Identificatore della griglia attualmente collegata al lavoro del corso e utilizzata per valutare il lavoro inviato dallo studente.

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

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 è associata alcuna rubrica al lavoro del corso o se è associata una rubrica, 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))

I voti assegnati in base ai criteri della griglia.

Questa mappa è vuota se non è associata alcuna griglia al lavoro del corso o se è associata una griglia, ma non sono stati impostati voti per nessuno dei criteri. 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

Indica se questo invio dello studente è associato al progetto della console dello sviluppatore che effettua la richiesta.

Per ulteriori dettagli, visita la pagina courseWork.create.

Sola lettura.
submissionHistory[]

object (SubmissionHistory)

La cronologia dell'invio (include le cronologie 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à dell'API rese disponibili per gli 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 inviati quando courseWorkType è ASSIGNMENT.

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

object (ShortAnswerSubmission)

Contenuti inviati quando courseWorkType è SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenuti inviati quando courseWorkType è MULTIPLE_CHOICE_QUESTION.

RubricGrade

Un voto della griglia impostato per i contenuti inviati dallo 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. (Facoltativo) ID 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 o meno punti. Se non impostato, non sono stati impostati punti per questo criterio.

AssignmentSubmission

Il lavoro dello 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 una modalità di condivisione di STUDENT_COPY potrebbero non esistere ancora se lo studente non ha ancora eseguito l'accesso al compito in Classroom.

Alcuni metadati degli allegati vengono compilati solo se l'utente che effettua la richiesta ha l'autorizzazione ad accedervi. I campi Identifier e alternateLink sono sempre disponibili, ma altri (ad esempio title) potrebbero non esserlo.

Allegato

Allegato aggiunto al lavoro dello studente per il compito.

Quando crei gli 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

Il 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 selezionata dallo studente.

SubmissionHistory

La cronologia dell'invio. Attualmente sono incluse le cronologie dello stato 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. Tipo di SubmissionHistory, può essere uno dei seguenti: StateHistory, 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 del compito, se presenti.

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 flusso di lavoro.
stateTimestamp

string (Timestamp format)

Quando l'invio è passato in questo stato.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 valore non deve 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 il documento assegnato allo studente.
RECLAIMED_BY_STUDENT Lo studente ha consegnato il documento assegnato, quindi ha scelto di "annullare l'invio" del compito, ottenendo di nuovo il controllo in qualità di proprietario.
STUDENT_EDITED_AFTER_TURN_IN Lo studente ha modificato il compito dopo averlo inviato. Attualmente, viene utilizzato solo da Domande, quando lo studente modifica la risposta.

GradeHistory

La cronologia di ogni voto per 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 di invio.
maxPoints

number

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

string (Timestamp format)

Quando è stato modificato il voto del compito.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 modificato il voto.
gradeChangeType

enum (GradeChangeType)

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

GradeChangeType

Possibili tipi di modifica del voto.

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

Metodi

get

 Restituisce i contenuti inviati da uno studente.

list

 Restituisce un elenco di compiti dello studente che l'utente che effettua la richiesta può visualizzare, tenendo conto degli ambiti OAuth della richiesta.

modifyAttachments

 Modifica gli allegati inviati dagli studenti.

patch

 Aggiorna uno o più campi di un invio dello studente.

reclaim

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

return

 Restituisce i contenuti inviati da uno studente.

turnIn

 Consegna un compito dello studente.