Strategia di implementazione

Questa pagina fornisce una breve panoramica delle interazioni principali tra l'applicazione web del tuo componente aggiuntivo e l'API dei componenti aggiuntivi di Google Classroom.

Iframe di Rilevamento degli allegati

L'iframe di Rilevamento degli allegati è la pagina di destinazione per gli insegnanti nel tuo componente aggiuntivo. Valuta la possibilità di intraprendere le seguenti azioni in merito a questa visualizzazione:

  • Mostrare l'interfaccia utente per la scoperta o la creazione di contenuti.

    Facoltativamente, determina se l'elemento dello stream accetterà le risposte degli studenti, dato che potresti voler impedire all'insegnante di aggiungere allegati di tipo attività. Controlla il valore del parametro di query itemType che è stato trasmesso quando è stato aperto l'iframe del componente aggiuntivo. Solo il tipo courseWork accetta risposte degli studenti.

  • In base alle selezioni dell'insegnante, invia una o più richieste di componenti aggiuntivi create per aggiungere allegati al compito.

Altri iframe

L'iframe Visualizzazione studenti, l'iframe Revisione dei lavori degli studenti e l'iframe Visualizzazione insegnante hanno tutti lo scopo di presentare contenuti all'utente anziché modificare un compito di Classroom. Valuta la possibilità di intraprendere le seguenti azioni in merito a queste visualizzazioni:

  • Quando si apre un iframe, ottieni il consenso OAuth dell'utente e convalida il suo ruolo e l'ID allegato.
  • Quando si apre un iframe, crea un courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest o announcements.GetAddOnContextRequest in base al itemType per convalidare il ruolo utente.
  • Se l'utente corrente è uno studente, associa il submissionId della risposta al lavoro dello studente. Questo è necessario per restituire i voti e mostrare il lavoro degli studenti agli insegnanti nello strumento di valutazione. I voti devono essere uguali in tutte le visualizzazioni.submissionIds
  • Se attachmentId è già noto per il componente aggiuntivo, mostra l'interfaccia utente appropriata dell'allegato.
  • In caso contrario, il post principale di questo allegato deve essere stato copiato da un altro post o corso. Utilizza copyHistory per identificare la copia più recente di cui è a conoscenza il componente aggiuntivo e copia le impostazioni per creare un nuovo modello corrispondente del componente aggiuntivo. Quindi, mostrare l'interfaccia utente dell'allegato appropriata.