Strategia di implementazione

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

iframe discovery dell'allegato

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

• Mostra l'UI di creazione o rilevamento dei 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à. Verifica il valore del parametro di query itemType che è stato passato quando è stato aperto l'iframe del componente aggiuntivo. Solo il tipo courseWork accetta le risposte degli studenti.

• In base alle selezioni dell'insegnante, effettua una o più richieste create aggiuntive per aggiungere allegati al compito.

Altri iframe

L'iframe della vista studente, dell'iframe della revisione del lavoro dello studente e dell'iframe della visualizzazione dell'insegnante sono tutti destinati a presentare contenuti all'utente anziché a modificare un compito di Classroom. Valuta la possibilità di intraprendere le seguenti azioni in merito a queste opinioni:

• All'apertura di un iframe, richiedi il consenso OAuth dell'utente e poi convalida il suo ruolo e l'ID allegato.
• Quando si apre un iframe, crea un elemento courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest o announcements.GetAddOnContextRequest in base al itemType per convalidare il ruolo utente.
• Se l'utente corrente è uno studente, associa submissionId della risposta al lavoro dello studente. Questo è necessario per ritrasmettere i voti e per mostrare i lavori degli studenti agli insegnanti nello strumento di valutazione. submissionIds corrisponde a tutte le visualizzazioni.
• Se attachmentId è già noto per il componente aggiuntivo, mostra l'interfaccia utente appropriata dell'allegato.
• Altrimenti, è necessario che il post principale di questo allegato sia stato copiato da un altro post o corso. Utilizza copyHistory per identificare la copia più recente di cui il componente aggiuntivo è a conoscenza e copia le impostazioni dal componente aggiuntivo per creare un nuovo modello corrispondente dell'allegato sul lato del componente aggiuntivo. Quindi, mostra la UI appropriata per gli allegati.