Strategia di implementazione

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

Iframe per rilevamento allegati

L'iframe della scoperta degli allegati è la pagina di destinazione nel componente aggiuntivo per gli insegnanti. Ti consigliamo di eseguire le seguenti azioni in merito a questa visualizzazione:

  • Quando si apre l'iframe di rilevamento degli allegati, crea un elemento courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest o announcements.GetAddOnContextRequest in base al itemType per convalidare il ruolo utente e ottenere il valore supportsStudentWork.
  • Mostra la UI di creazione o rilevamento dei contenuti. Potresti omettere gli allegati per tipo di attività in base al valore di supportsStudentWork nella risposta di convalida del lancio.
  • In base alle selezioni degli insegnanti, effettua una o più richieste create aggiuntive per aggiungere allegati al compito.

Altri iframe

L'iframe della visualizzazione dello studente, l'iframe della recensione del lavoro dello studente e l'iframe della visualizzazione dell'insegnante hanno lo scopo di presentare contenuti all'utente anziché modificare un compito di Classroom. Valuta se eseguire le seguenti azioni in merito a queste visualizzazioni:

  • Quando si apre un iframe, ottieni il consenso OAuth dell'utente e poi convalida il suo ruolo e l'ID allegato.

    • Se l'utente corrente è uno studente, associa submissionId della risposta al lavoro dello studente. Questo passaggio è necessario per ritrasmettere i voti e per mostrare il lavoro degli studenti agli insegnanti nello strumento di valutazione; submissionIds le visualizzazioni corrispondono.
    • Se attachmentId è già noto per il componente aggiuntivo, mostra la UI dell'allegato appropriata.
    • 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 il componente aggiuntivo è a conoscenza e copiane le impostazioni per creare un nuovo modello corrispondente dell'allegato sul lato del componente aggiuntivo. Quindi, mostra la UI appropriata per gli allegati.