I componenti aggiuntivi di Google Classroom sono ora in disponibilità generale per gli sviluppatori. Per ulteriori informazioni, consulta la documentazione relativa ai componenti aggiuntivi.

Questa pagina è stata tradotta dall'API Cloud Translation.

Requisiti per i componenti aggiuntivi

Versione 1.0, 30 aprile 2024.

I criteri in questa pagina si applicano a tutti i componenti aggiuntivi di Classroom. Il componente aggiuntivo deve soddisfare tutti gli elementi obbligatori applicabili per essere approvato per la scheda in Google Workspace Marketplace e un componente aggiuntivo "Compatibile con Classroom".

Le parole chiave "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" e "OPTIONAL" in questo documento devono essere interpretate come descritto nel documento RFC 2119.

Requisiti

ID			Tipo
1,00	Licenza dell'utente finale (se applicabile)
	1.1	Quando l'utente non dispone di una licenza, DEVE essere mostrato un messaggio di facile utilizzo. Il messaggio DEVE indicare chiaramente il motivo per cui il componente aggiuntivo non può essere utilizzato e suggerire all'utente una linea d'azione per risolvere la situazione.	REQUIRED
	1.3	L'elenco di Google Workspace Marketplace del componente aggiuntivo DEVE specificare i dettagli sui requisiti di licenza che potrebbero essere richiesti per utilizzare il componente aggiuntivo. Se il componente aggiuntivo ha un livello a pagamento, la scheda di Marketplace DEVE fornire un link a una pagina web che fornisce ulteriori informazioni sui prezzi o su come contattare un addetto alle vendite.	REQUIRED
2,00	Accesso degli utenti finali
	2.1	Gli utenti degli insegnanti DEVONO accedere al componente aggiuntivo utilizzando l'accesso SSO di Google. Se agli utenti studenti viene chiesto di accedere al componente aggiuntivo, DEVONO farlo utilizzando l'accesso SSO di Google.	REQUIRED
	2.2	Il componente aggiuntivo DEVE utilizzare l'accesso SSO di Google per far accedere automaticamente un utente alle visite successive senza mostrare una richiesta di accesso. Quando il suggerimento di accesso non produce una corrispondenza con l'utente che ha eseguito l'accesso, il componente aggiuntivo DEVE richiedere all'utente un pulsante di accesso e passare il metodo login_hint alla libreria di autenticazione per filtrare gli account non validi.	REQUIRED
	2,7	Quando l'utente di Classroom non ha ancora eseguito l'accesso al componente aggiuntivo (come stabilito dal suggerimento di accesso), quest'ultimo DEVE presentare un pulsante "Accedi con Google" affinché un'azione esplicita dell'utente attivi la procedura di accesso. Nota: questa operazione è necessaria per rispettare le linee guida per il branding di Google e anche per evitare il blocco dei popup.	REQUIRED
	2,8	Il componente aggiuntivo DEVE mostrare chi è l'utente che ha eseguito l'accesso.	CONSIGLIATO
3,0	Generali
	3.1	Il componente aggiuntivo DEVE rispettare le linee guida generali per l'approvazione di Google Workspace Marketplace.	REQUIRED
	3.2	Se un'attività viene lanciata in una nuova scheda o finestra da uno qualsiasi dei percorsi iframe, DEVE fornire un messaggio facile da usare per tornare a Classroom.	REQUIRED
	3.3	L'utente DEVE completare il percorso soltanto utilizzando un flusso di lavoro aggiuntivo e non passare a un flusso di lavoro del corso o utilizzare il pulsante di condivisione di Classroom.	REQUIRED
	3.4	Scelta della localizzazione: la lingua DEVE essere basata sulle preferenze locali impostate dal browser, se disponibili.	CONSIGLIATO
	3,5	Se un componente aggiuntivo definisce `maxPoints`, DEVE impostare anche `pointsEarned` quando uno studente completa un invio utilizzando le credenziali dell'insegnante memorizzate (opzione consigliata) OPPURE quando l'insegnante apre il contenuto inviato nell'iframe della revisione del lavoro dello studente.	REQUIRED
	3,9	I componenti aggiuntivi DEVONO essere conformi alle linee guida delle WCAG 2.1 AA di livello sull'accessibilità. Gli sviluppatori dei componenti aggiuntivi segnaleranno autonomamente che questo requisito è soddisfatto al momento dell'invio e che il componente aggiuntivo continua a rimanere conforme alle future modifiche.	CONSIGLIATO
	3,10	Gli eventuali errori riscontrati da un utente DEVONO essere leggibili da una persona.	REQUIRED
	3,11	Se `studentViewUri`, `teacherViewUri` o `studentWorkViewUri` viene avviato da un compito o un corso copiato, il componente aggiuntivo NON DEVE visualizzare una pagina di errore nell'iframe.	REQUIRED
	3,12	Se `studentViewUri`, `teacherViewUri` o `studentWorkViewUri` vengono avviati da un compito o un corso copiato, il componente aggiuntivo DEVE mostrare un nuovo allegato da completare per lo studente e NON DEVE mostrare nell'iframe le risposte di uno studente relative a compiti o corsi precedenti.	CONSIGLIATO
4,00	Rilevamento degli allegati
	4.1	Se un allegato richiede l'invio di uno studente, DEVE includere un `studentWorkReviewUri` in modo da essere considerato come un tipo di attività e non come un allegato di tipo di contenuto.	REQUIRED
	4.2	L'iframe di rilevamento dell'allegato DEVE fornire un'interfaccia utente che offra almeno uno dei seguenti elementi: Crea nuovi contenuti da allegare Sfogliare, selezionare e allegare da una raccolta di contenuti Istruzioni per allegare contenuti dal tuo sito web o da altri prodotti	REQUIRED
	4.3	L'insegnante DEVE essere in grado di trovare e accedere a tutti i contenuti/attività a sua disposizione.	CONSIGLIATO
	4.4	L'insegnante DEVE essere in grado di visualizzare l'anteprima dei contenuti/dell'attività prima di impegnarsi ad allegarli al compito.	REQUIRED
	4,5	Se l'insegnante ha bisogno di un lavoro per creare contenuti/attività prima che possano essere allegati, tale lavoro DEVE essere completato nell'iframe.	CONSIGLIATO
5,00	Vista studente
	5.1	Quando viene lanciato `studentViewUri`, il componente aggiuntivo NON DEVE estrarre l'utente dall'iframe per completare un'attività. Se il componente aggiuntivo esce dall'iframe, DEVE essere presente un messaggio o un'altra indicazione per gli studenti per tornare in Classroom.	CONSIGLIATO
	5.2	Se un'attività di componente aggiuntivo esce dall'iframe, DEVE essere presente un'anteprima dell'attività nell'iframe.	REQUIRED
	5.3	Se un'attività richiede che uno studente intraprenda un'azione per contrassegnare il lavoro completato, il pulsante NON DEVE essere etichettato come "Consegna" per evitare confusione con il pulsante Consegna di Classroom.	REQUIRED
6,0	Visualizzazione insegnante
	6,1	L'insegnante DEVE essere in grado di vedere cosa vedrà lo studente quando completa il compito.	CONSIGLIATO
7,0	Revisione del lavoro dello studente
	7,1	Se viene lanciato `studentWorkReviewUri`, il componente aggiuntivo DEVE visualizzare il lavoro dello studente affinché possa essere esaminato dall'insegnante all'interno dell'iframe. Il materiale supplementare può rimandare al di fuori dell'iframe.	REQUIRED
	7.2	Il componente aggiuntivo NON DEVE abilitare la navigazione tra gli studenti nella vista `studentWorkReviewUri`. La navigazione tra gli studenti DEVE avvenire solo nell'interfaccia utente di Classroom.	REQUIRED
8,0	Assistenza Classroom per il mobile
	8.1	Quando l'app mobile Classroom avvia un `teacherViewUri`, `studentViewUri` o `studentWorkReviewUri`, l'URL DEVE aprire l'app nativa mobile del partner o l'app web mobile del partner e, in entrambi i casi, rimandare direttamente alla visualizzazione corretta. Se il dispositivo non è supportato, DEVE essere visualizzato un messaggio che comunica all'utente che si tratta di un dispositivo non supportato e, idealmente, quali sono i dispositivi supportati.	REQUIRED
	8.2	Il lavoro degli studenti DEVE essere completato su un dispositivo mobile.	CONSIGLIATO
9,0	Altre funzionalità
	9.1	Se gli insegnanti possono incollare i link ai tuoi contenuti come allegati ai link, DOVRESTI eseguire l'upgrade dei link agli allegati dei componenti aggiuntivi.	CONSIGLIATO
	9.2	Se utilizzi un'integrazione di CourseWork per creare compiti al di fuori di Classroom, DOVRESTI creare allegati aggiuntivi per impostazione predefinita per tutti i link compatibili con il componente aggiuntivo.	CONSIGLIATO

Log delle modifiche

Versione 1.0	Ultimo aggiornamento: 30 aprile 2024
1.1	Combinazione dei punti 1.1 e 1.2 in un unico requisito.
2.1	Combinazione dei punti 2.1 e 2.5 in un unico requisito.
2.2	Combinazione dei punti 2.2, 2.3 e 2.4 in un unico requisito.
3,5	Combinazione di 3.5, 3.6 e 3.7 in un unico requisito.
3,10	È stato aggiunto un requisito secondo cui il componente aggiuntivo non entra mai in uno stato incomprensibile o non recuperabile.
3,11, 3,12	Combinazione di 5.5, 5.6, 6.3, 6.4, 7.5 e 7.6 in due nuovi requisiti.
4.2	È stata espansa la descrizione delle esperienze di rilevamento degli allegati accettabili.
4.3	Rinumerato, in precedenza 4.2. Anche cambiato da REQUIRED a CONSIGLIATO.
4.4	Rinumerato, in precedenza 4.3.
4,5	Rinumerato, in precedenza 4.4.
5.2	Rinumerato, in precedenza 5.3.
5.3	Rinumerato, in precedenza 5.2.
9.1	È stato aggiunto un consiglio per eseguire l'upgrade dei link incollati negli allegati.
9.2	È stato aggiunto un suggerimento per creare allegati di componenti aggiuntivi per impostazione predefinita quando si creano compiti di Lavoro del corso in modo programmatico.
2,6, 3,7, 3,8, 6,2, 7,3, 7,4	Rimosso.
Versione 0.3	Ultimo aggiornamento: 22 novembre 2022
2.3	Correzione delle indicazioni dei suggerimenti per l'accesso.
2.4	È stato incorporato uno scenario in cui è richiesta l'implementazione di `hd`.
3.2	Riformulato "Fornisci percorso".
5,5, 5,6, 6,3, 6,4, 7,5, 7,6	Sono stati aggiunti i testi del corso obbligatori e consigliati per `studentViewUri`, `teacherViewUri` e `studentWorkReviewUri`.
Versione 0.2	Ultimo aggiornamento: 29 ottobre 2021
1.3	Abbiamo modificato il testo per renderlo più chiaro.
3.1	È stata aggiunta la dicitura "Il componente aggiuntivo DEVE rispettare le linee guida generali per l'approvazione di GWM presenti sul sito web".
3,9	WCAG è cambiato da REQUIRED a RECOMMENDED.
5.1	Cambiato da REQUIRED a CONSIGLIATO.
5.3	È stato aggiunto il messaggio "Se il componente aggiuntivo esce dall'iframe, DEVE avere un'anteprima dell'attività nell'iframe".
5,4	È stato aggiunto il messaggio "Se il componente aggiuntivo esce dall'iframe, DEVE essere visualizzata una richiesta agli studenti di tornare in Classroom".
8.1	È stato aggiunto il messaggio "Se il dispositivo non è supportato, DEVE essere mostrato all'utente un messaggio che comunica che si tratta di un dispositivo non supportato e, idealmente, quali dispositivi sono supportati".
8.2	Il lavoro da dispositivo mobile degli studenti è stato modificato da REQUIRED a CONSIGLIATO.
Versione 0.1	Ultimo aggiornamento: 22 settembre 2021
	Rilascio iniziale.