Interagire con gli allegati

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 e dueTime 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:

  1. Uno studente avvia studentViewUri per completare un'attività.
  2. Il componente aggiuntivo recupera un submissionId dal metodo getAddOnContext usando le credenziali dello studente.
  3. submissionId e attachmentId 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.
  4. Un insegnante interessato a rivedere i lavori degli studenti avvia la studentWorkReviewUri. La richiesta include i seguenti parametri di query: courseId, itemId, itemType, attachmentId e submissionId.
  5. 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 o RECLAIMED_BY_STUDENT, lo studente potrebbe essere autorizzato a modificare per l'invio. Se lo stato del compito è TURNED_IN o RETURNED, 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à.