In questa pagina vengono descritti i dettagli dell'implementazione per la creazione di un allegato e l'utilizzo dei contenuti inviati dagli studenti. Tieni presente che potrebbe essere necessario fornire parametri relativi agli allegati quando effettui queste richieste.
Crea un allegato
Crea un allegato inviando una richiesta CREATE
all'endpoint courses.*.addOnAttachments.create
appropriato. La richiesta deve includere un'istanza di AddOnAttachment
nel corpo della richiesta.
I seguenti campi sono obbligatori per la creazione di un allegato:
title
: il nome della stringa dell'allegato.teacherViewUri
: l'URI della Visualizzazione insegnante dell'allegato.studentViewUri
: l'URI della Visualizzazione studente dell'allegato.studentWorkReviewUri
: l'URI che consente all'insegnante di visualizzare il lavoro dello studente nell'allegato. Questo campo è obbligatorio solo per gli allegati di tipo attività.
Ti consigliamo di includere alcuni dei seguenti campi facoltativi:
dueDate
edueTime
se specifichi la data di scadenza dell'allegato.maxPoints
: il voto massimo per l'allegato. Deve essere un valore diverso da zero se vuoi supportare l'invio dei voti. Si applica solo agli allegati di tipo attività.
Consulta il riferimento delle risorse AddOnAttachment
per maggiori dettagli su questi campi.
Dettagli dell'invio dello studente
Un tipico flusso di lavoro di invio segue questi passaggi:
- Uno studente avvia
studentViewUri
per completare un'attività. - Il componente aggiuntivo recupera un
submissionId
dal metodogetAddOnContext
utilizzando le credenziali dello studente. submissionId
eattachmentId
vengono memorizzati dallo sviluppatore del componente aggiuntivo come identificatore univoco del lavoro dello studente. Nel caso in cui un insegnante copi un compito in Classroom, puoi utilizzare la chiave composita di questi due parametri per visualizzare un nuovo allegato nel compito copiato. Per ulteriori dettagli, visita la nostra pagina relativa ai contenuti copiati.- Un insegnante interessato a rivedere i lavori degli studenti lancia
studentWorkReviewUri
. La richiesta include i seguenti parametri di query:courseId
,itemId
,itemType
,attachmentId
esubmissionId
. - Lo sviluppatore del componente aggiuntivo utilizza questi quattro ID per recuperare il lavoro dello studente. Utilizza
l'endpoint
courses.courseWork.addOnAttachments.studentSubmissions
per recuperare o modificare le informazioni sui contenuti inviati da uno studente.
Rileva stato di invio
Invia una richiesta GET
all'endpoint
courses.courseWork.addOnAttachments.studentSubmissions
per ottenere
i dettagli su un submissionId
specifico. Ricevi un oggetto AddOnAttachmentStudentSubmission
, che contiene il voto (pointsEarned
) e lo stato attuale (postSubmissionState
) dell'invio. Lo stato di invio può essere uno dei seguenti valori:
NEW
, se lo studente non ha mai eseguito l'accesso ai contenuti inviati.CREATED
, se lo studente ha creato un compito ma non l'ha ancora inviato.TURNED_IN
, se lo studente ha inviato il suo lavoro all'insegnante.RETURNED
, se l'insegnante ha restituito il compito allo studente.RECLAIMED_BY_STUDENT
, se lo studente ha "ritirato" il lavoro.
Utilizza questo endpoint per rilevare lo stato del lavoro dello studente nel componente aggiuntivo. Puoi quindi modificare le visualizzazioni o le opzioni fornite allo studente a seconda dello stato restituito. Potrebbero essere incluse funzionalità quali:
- Visualizzazione dello stato di consegna dei compiti all'interno del componente aggiuntivo. Ciò può aiutare gli studenti a evitare potenziali confusione e ad assicurarsi di non riuscire a consegnare un compito per errore.
- Limitazione dei privilegi di modifica dei contenuti inviati. Se il compito ha lo stato
CREATED
oRECLAIMED_BY_STUDENT
, lo studente potrebbe essere autorizzato a modificare i contenuti inviati. Se lo stato del compito èTURNED_IN
oRETURNED
, lo studente potrebbe non essere autorizzato a modificare i contenuti inviati.
Voti e più allegati
È possibile utilizzare un solo allegato del componente aggiuntivo per impostare il voto per un singolo compito. Se un insegnante crea più allegati per il tipo di attività che
fornisce un valore maxPoints
, solo il primo allegato di questo tipo può impostare
il voto del compito. Lascia il valore maxPoints
non impostato o impostalo su zero per disabilitare il pass-back dei voti per un allegato.
Impostare il voto di un invio
Puoi modificare i contenuti inviati da uno studente inviando una richiesta PATCH
all'endpoint
courses.courseWork.addOnAttachments.studentSubmissions
. Il corpo della richiesta deve includere un'istanza di AddOnAttachmentStudentSubmission
con i valori modificati. Imposta il campo pointsEarned
per modificare il voto di un invio.
Il valore trasmesso in pointsEarned
diventa un voto provvisorio visibile all'insegnante nell'interfaccia utente di Classroom. Gli insegnanti possono modificare il voto provvisorio
prima di restituire il compito agli studenti. Per maggiori dettagli su come vengono presentati i voti agli insegnanti, consulta la Panoramica della valutazione nell'interfaccia utente di Classroom.
Tieni presente che puoi impostare il voto con pointsEarned
solo se si verificano le seguenti condizioni:
- L'allegato deve avere un valore
maxPoints
positivo. - Il componente aggiuntivo deve essere stato l'autore originale dell'allegato.
Tieni inoltre presente che puoi modificare il valore maxPoints
di AddOnAttachment
già creato inviando una richiesta PATCH
all'endpoint addOnAttachments
.
Quando impostare un voto
Puoi scegliere quando restituire il voto a Google Classroom. La differenza fondamentale consiste nel fatto che tu scelga o meno di archiviare le credenziali dell'insegnante, in quanto solo l'insegnante può modificare un voto.
Esistono due momenti aggiuntivi in cui puoi passare un voto a Google Classroom: quando lo studente completa il proprio lavoro o quando l'insegnante apre il lavoro dello studente nell'iframe Revisione lavoro dello studente.
Se vuoi impostare i voti quando lo studente completa il lavoro, devi memorizzare le credenziali offline di un insegnante, quindi recuperarle e utilizzarle per modificare il voto quando lo studente completa il lavoro. Questo metodo offre alcuni potenziali vantaggi:
- Fornire aggiornamenti immediati dei voti. Gli insegnanti non devono intraprendere alcuna azione speciale per completare i voti nell'interfaccia utente di Classroom.
- Fornire informazioni in tempo reale sui progressi di un corso attraverso un compito. Impostando i voti quando gli studenti completano gli allegati, gli insegnanti possono farsi un'idea della comprensione dei loro studenti senza dover aprire ogni invio.
Tieni presente che questo approccio consente anche un approccio asincrono per la sincronizzazione dei voti. Potresti sottoporre periodicamente a sondaggio l'endpoint AddOnAttachmentStudentSubmission
per rilevare quando uno studente ha inviato il suo lavoro. Una volta inviato, imposta il voto utilizzando le credenziali archiviate.
Se non vuoi caricare le credenziali dell'insegnante durante una sessione dello studente, puoi utilizzare le credenziali dell'insegnante attivo quando caricano i contenuti inviati dallo studente nell'iframe Student Work Review. Tuttavia, ciò potrebbe non garantire un'esperienza utente particolarmente fluida, poiché i voti nell'interfaccia utente di Classroom non vengono aggiornati in tempo reale e gli insegnanti sono tenuti ad aprire l'iframe della recensione del lavoro dello studente di ogni invio.
Rilevare le modifiche ai voti dei compiti
gli insegnanti possono modificare le impostazioni dei voti in Classroom dopo aver creato un compito. Le modifiche possono includere:
- Modifica il valore dei punti assegnati.
- Modifica del valore
maxPoints
di un compito. - Modificando se il compito deve essere valutato o meno.
Per visualizzare le impostazioni di valutazione attuali di un compito, ti consigliamo di inviare
una richiesta GET
all'endpoint courses.courseWork
. La risposta include
l'attuale valore maxPoints
. Un compito senza voto ha un valore maxPoints
nullo o zero.
Se hai restituito un voto a Classroom, utilizza l'endpoint courses.courseWork.addOnAttachments.studentSubmissions
per recuperare o
modificare il voto di un allegato aggiuntivo. Il valore del voto viene impostato utilizzando il campo pointsEarned
. Valuta la possibilità di controllare e, se necessario, di aggiornare questo valore
se il tuo prodotto consente agli insegnanti di modificare il punteggio di uno studente per una determinata
attività.