- Risorsa: Presentazione dello studente
- RubricGrade
- AssignmentSubmission
- Allegato
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Stato
- GradeHistory
- GradeChangeType
- Metodi
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 ( |
Campi | |
---|---|
courseId |
Identificatore del corso. Sola lettura. |
courseWorkId |
Identificatore del lavoro del corso a cui corrisponde. Sola lettura. |
id |
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 |
Identificatore dello studente proprietario dei contenuti inviati. Sola lettura. |
creationTime |
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: |
updateTime |
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: |
state |
Stato dei contenuti inviati. Sola lettura. |
late |
Indica se l'invio è in ritardo. Sola lettura. |
draftGrade |
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 |
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 |
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 |
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 |
assignedRubricGrades |
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 |
alternateLink |
Link assoluto al contenuto inviato nell'interfaccia utente web di Classroom. Sola lettura. |
courseWorkType |
Il tipo di lavoro del corso a cui è destinato l'invio. Sola lettura. |
associatedWithDeveloper |
Se l'invio dello studente è associato al progetto della Developer Console che ha effettuato la richiesta. Per maggiori dettagli, visita la pagina Sola lettura. |
submissionHistory[] |
La cronologia dei contenuti inviati (incluse le cronologie statali e dei voti). Sola lettura. |
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 |
Contenuti da inviare quando il campo CourseWorkType è ASSIGNMENT. Gli studenti possono modificare questi contenuti utilizzando |
shortAnswerSubmission |
Invia contenuti quando il campo CourseWorkType è SHORT_ANSWER_QUESTION. |
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 |
(Facoltativo) ID criterio: |
levelId |
(Facoltativo) ID livello facoltativo del livello selezionato. Se vuoto, non è stato selezionato alcun livello. |
points |
(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 ( |
Campi | |
---|---|
attachments[] |
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 |
Campi | |
---|---|
Campo 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
Il lavoro dello studente per una domanda a scelta multipla.
Rappresentazione JSON |
---|
{ "answer": string } |
Campi | |
---|---|
answer |
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 |
Campi | |
---|---|
Campo unione type . Type of SubmissionHistory, può essere StateHistory, GradeHistory. type può essere solo uno dei seguenti: |
|
stateHistory |
Le informazioni sulla cronologia dello stato dei contenuti inviati, se presenti. |
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 ( |
Campi | |
---|---|
state |
La fase della pipeline del flusso di lavoro. |
stateTimestamp |
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: |
actorUserId |
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 ( |
Campi | |
---|---|
pointsEarned |
Il numeratore del voto in questo momento nella cronologia dei voti inviati. |
maxPoints |
Il denominatore del voto in questo momento nella cronologia dei voti inviati. |
gradeTimestamp |
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: |
actorUserId |
L'insegnante che ha apportato la modifica. |
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 |
|
---|---|
|
Restituisce i contenuti inviati da uno studente. |
|
Restituisce un elenco dei contenuti inviati dagli studenti che il richiedente può 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. |
|
Recupera i contenuti inviati da uno studente per conto dello studente proprietario. |
|
Restituisce i contenuti inviati da uno studente. |
|
Consegna i contenuti inviati da uno studente. |