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
oannouncements.GetAddOnContextRequest
in base alitemType
per convalidare il ruolo utente e ottenere il valoresupportsStudentWork
. - 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.
- Se l'utente corrente è uno studente, associa