In questa pagina vengono descritti i dettagli dell'implementazione per la creazione di un allegato e lavorare con i contenuti inviati dagli studenti. Tieni presente che potresti dover fornire parametri correlati agli allegati quando si effettuano queste richieste.
Crea un allegato
Crea un allegato inviando una richiesta CREATE
all'indirizzo
Endpoint courses.*.addOnAttachments.create
. La richiesta deve includere un
dell'istanza di AddOnAttachment
nel corpo della richiesta.
I seguenti campi sono obbligatori durante la creazione di un allegato:
title
: il nome della stringa dell'allegato.teacherViewUri
: l'URI della visualizzazione per gli insegnanti dell'allegato.studentViewUri
: l'URI della visualizzazione studente dell'allegato.studentWorkReviewUri
: l'URI su cui l'insegnante può vedere il lavoro dello studente dell'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 per supportare il pass-back dei voti. Si applica agli allegati di tipo attività .
Per ulteriori dettagli su questi campi, consulta la guida di riferimento della risorsa AddOnAttachment
.
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
usando le credenziali dello studente. submissionId
eattachmentId
vengono archiviati dal componente aggiuntivo sviluppatore come identificatore univoco del lavoro dello studente. Nel caso in cui un insegnante copia un compito in Classroom, puoi utilizzare chiave composita di questi due parametri per visualizzare un nuovo allegato nel compito copiato. Per ulteriori dettagli, consulta la nostra pagina sui contenuti copiati.- Un insegnante interessato a rivedere i lavori degli studenti avvia la
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 le funzionalità di
l'endpoint
courses.courseWork.addOnAttachments.studentSubmissions
recuperare o modificare le informazioni relative ai contenuti inviati da uno studente.
Rileva stato di invio
Invia una richiesta GET
a
courses.courseWork.addOnAttachments.studentSubmissions
per ottenere
dettagli di uno specifico submissionId
. Ricevi
Oggetto AddOnAttachmentStudentSubmission
, che contiene il voto dell'invio
(pointsEarned
) e stato corrente (postSubmissionState
). Stato dell'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 invio ma non li ha ancora inviati.TURNED_IN
, se lo studente ha inviato il suo lavoro all'insegnante.RETURNED
, se l'insegnante ha restituito i contenuti inviati allo studente.RECLAIMED_BY_STUDENT
, se lo studente ha annullato l'invio il proprio lavoro.
Utilizza questo endpoint per rilevare lo stato del lavoro dello studente nel tuo componente aggiuntivo. Tu può quindi modificare le visualizzazioni o le opzioni fornite allo studente a seconda viene restituito. Potrebbero essere incluse funzionalità quali:
- Visualizzazione dello stato di consegna dei compiti all'interno del componente aggiuntivo. Questo può aiutano gli studenti a evitare potenziali confusione e ad assicurarsi che non non consegnano un compito.
- Limitazione dei privilegi di modifica per l'invio. Se il compito ha uno stato
CREATED
oRECLAIMED_BY_STUDENT
, lo studente potrebbe essere autorizzato a modificare per l'invio. Se lo stato del compito èTURNED_IN
oRETURNED
, allo studente potrebbe non essere autorizzato a modificare i contenuti inviati.
Voti e più allegati
È possibile utilizzare un solo allegato di un componente aggiuntivo per impostare il voto per un singolo
. Se un insegnante crea più allegati di tipo attività che
fornisce un valore maxPoints
, solo il primo di questo collegamento può impostare
il voto del compito. Lascia il valore maxPoints
non impostato o impostalo su zero su
disattivare 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
. La richiesta
il corpo 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 nella UI di Classroom. Gli insegnanti possono modificare il voto provvisorio
prima di restituire il compito agli studenti. Consulta la Panoramica della valutazione in
UI di Classroom per i dettagli su come vengono i voti
presentati agli insegnanti.
Tieni presente che puoi impostare il voto con pointsEarned
solo se:
vero:
- L'allegato deve avere un valore
maxPoints
positivo. - Il componente aggiuntivo deve essere l'autore originale dell'allegato.
Tieni inoltre presente che puoi modificare un elemento maxPoints
di AddOnAttachment
già creato
inviando una richiesta PATCH
all'endpoint addOnAttachments
.
Quando impostare un voto
Hai la possibilità di scegliere quando restituire un voto a Google Classroom. La una distinzione fondamentale è se scegli di memorizzare le credenziali dell'insegnante, solo l'insegnante può modificare un voto.
Esistono due momenti aggiuntivi in cui puoi superare un voto Google Classroom: quando lo studente completa il lavoro o quando l'insegnante apre il lavoro dello studente nell'iframe della revisione del lavoro dello studente.
Se vuoi impostare i voti quando lo studente completa il lavoro, devi archiviare una le credenziali offline dell'insegnante, quindi recuperale e utilizzale per modificare il voto quando lo studente completa il lavoro. Questo metodo offre potenziali vantaggi:
- Fornire aggiornamenti dei voti senza interruzioni. Gli insegnanti non devono fare nulla di speciale per inserire i voti nell'interfaccia utente di Classroom.
- Fornire informazioni in tempo reale sull'avanzamento di un corso attraverso un compito. Impostando i voti man mano che gli studenti completano gli allegati, gli insegnanti possono farsi un'idea dei loro studenti senza dover aprire tutti i contenuti inviati.
Tieni presente che questo approccio consente anche di utilizzare un approccio asincrono per valutare
sincronizzare. Potresti condurre periodicamente un sondaggio su AddOnAttachmentStudentSubmission
endpoint per rilevare quando uno studente ha inviato il proprio lavoro. Dopo
inviati, imposta il voto utilizzando le credenziali memorizzate.
Se non vuoi caricare le credenziali dell'insegnante durante una sessione per studenti, puoi utilizzare le credenziali dell'insegnante attivo quando carica inviati nell'iframe della revisione del lavoro dello studente. Tuttavia, ciò potrebbe non fornire un'esperienza utente particolarmente fluida con i voti nell'interfaccia utente di Classroom non si aggiornano in tempo reale e gli insegnanti dovrebbero aprire ogni l'iframe della revisione del lavoro dello studente inviato.
Rileva le modifiche nei voti dei compiti
gli insegnanti possono modificare le impostazioni dei voti Classroom dopo la creazione di un compito. Queste modifiche potrebbero include:
- Modifica del valore dei punti assegnati.
- Modifica del valore
maxPoints
di un compito. - Modifica dell'eventuale voto del compito.
Per visualizzare le attuali impostazioni di valutazione di un compito, ti consigliamo di inviare
una richiesta GET
all'endpoint courses.courseWork
. La risposta include
il valore maxPoints
corrente. Un compito senza voto ha un valore nullo o pari a zero.
Valore maxPoints
.
Se hai restituito il voto a Classroom, utilizza la
courses.courseWork.addOnAttachments.studentSubmissions
endpoint da recuperare o
modificare il voto per un allegato del componente aggiuntivo. Il valore del voto viene impostato utilizzando
campo pointsEarned
. Valuta la possibilità di controllare e, se necessario, aggiornare questo valore
se il tuo prodotto consente agli insegnanti di modificare il punteggio di uno studente per un
attività.