- Risorsa: Invio dello studente
- RubricGrade
- AssignmentSubmission
- Allegato
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Stato
- GradeHistory
- GradeChangeType
- Metodi
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 ( |
Campi | |
---|---|
courseId |
Identificatore del corso. Sola lettura. |
courseWorkId |
L'identificatore del lavoro del corso a cui corrisponde. Sola lettura. |
id |
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 |
Identificatore dello studente proprietario di questo invio. Sola lettura. |
creationTime |
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: |
updateTime |
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: |
state |
Stato dell'invio. Sola lettura. |
late |
Indica se l'invio è in ritardo. Sola lettura. |
draftGrade |
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 |
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 |
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 |
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 |
assignedRubricGrades |
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 |
alternateLink |
Link assoluto ai contenuti inviati nell'interfaccia utente web di Classroom. Sola lettura. |
courseWorkType |
Il tipo di lavoro del corso a cui si riferisce l'invio. Sola lettura. |
associatedWithDeveloper |
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 Sola lettura. |
submissionHistory[] |
La cronologia dei contenuti inviati (incluse le cronologie relative agli stati e ai voti). Sola lettura. |
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 |
Contenuti dell'invio quando CourseWorkType è ASSIGNMENT. Gli studenti possono modificare questi contenuti utilizzando |
shortAnswerSubmission |
Contenuti dell'invio quando il valore del campo CourseWorkType è SHORT_ANSWER_QUESTION. |
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 |
Campo facoltativo. ID criterio. |
levelId |
Campo facoltativo. ID facoltativo del livello selezionato. Se vuoto, non è stato selezionato nessun livello. |
points |
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 ( |
Campi | |
---|---|
attachments[] |
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 |
Campi | |
---|---|
Campo di unione attachment . Dati degli allegati. attachment può essere solo uno dei seguenti: |
|
driveFile |
Allegato file di Google Drive. |
youTubeVideo |
Allegato video di YouTube. |
link |
Link allegato. |
form |
Allegato di Moduli Google. |
ShortAnswerSubmission
Lo studente lavora per una domanda a risposta breve.
Rappresentazione JSON |
---|
{ "answer": string } |
Campi | |
---|---|
answer |
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 |
Scelto dallo studente. |
SubmissionHistory
La cronologia dei contenuti inviati. Attualmente sono incluse le cronologie relative agli stati e ai voti.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione type . Tipo di SubmissionHistory. Può essere uno dei valori StateHistory o GradeHistory. type può essere solo uno dei seguenti: |
|
stateHistory |
Le informazioni sulla cronologia dello stato dell'invio, se presenti. |
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 ( |
Campi | |
---|---|
state |
Fase della pipeline del flusso di lavoro. |
stateTimestamp |
Lo stato dei contenuti inviati. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
actorUserId |
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 ( |
Campi | |
---|---|
pointsEarned |
Il numeratore del voto al momento nella cronologia dei voti di invio. |
maxPoints |
La denominatore del voto in questo momento nella cronologia dei voti di invio. |
gradeTimestamp |
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: |
actorUserId |
L'insegnante che ha apportato la modifica al voto. |
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 |
|
---|---|
|
Restituisce il compito inviato da uno studente. |
|
Restituisce un elenco dei contenuti inviati dagli studenti che il richiedente è autorizzato a visualizzare, tenendo conto degli ambiti OAuth della richiesta. |
|
Modifica gli allegati dei contenuti inviati dagli studenti. |
|
Consente di aggiornare uno o più campi dei contenuti inviati da uno studente. |
|
Rivendica i contenuti inviati da uno studente per conto dello studente proprietario. |
|
Restituisce il compito inviato da uno studente. |
|
Consegna il lavoro inviato da uno studente. |