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 applicabili necessari per essere approvati per le schede in Google Workspace Marketplace e per un componente aggiuntivo "Funziona con Classroom".
Le parole chiave "DEV", "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,0 | Licenza dell'utente finale (se applicabile) | ||
| 1.1 | Quando l'utente non dispone di una licenza, DEVE essere mostrato un messaggio facile da usare. Il messaggio DEVE indicare chiaramente il motivo per cui il componente aggiuntivo non può essere utilizzato e suggerire all'utente un intervento per rimediare alla situazione. | OBBLIGATORIO | |
| 1.3 | La scheda del componente aggiuntivo Google Workspace Marketplace DEVE specificare 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 del Marketplace DEVE fornire un link a una pagina web che fornisce ulteriori informazioni sui prezzi o su come contattare un commerciale. | OBBLIGATORIO | |
| 2,00 | Accesso dell'utente finale | ||
| 2.1 | Gli utenti Insegnante DEVONO accedere al componente aggiuntivo utilizzando l'accesso SSO di Google. Se viene chiesto agli utenti studenti di accedere al componente aggiuntivo, DEVONO accedere utilizzando l'accesso SSO di Google. |
OBBLIGATORIO | |
| 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 corrisponde all'utente che ha effettuato l'accesso, il componente aggiuntivo DEVE richiedere all'utente di accedere con un pulsante di accesso e passare il login_hint alla libreria di autenticazione per filtrare gli account non validi. |
OBBLIGATORIO | |
| 2,7 | Quando l'utente di Classroom non ha ancora effettuato l'accesso al componente aggiuntivo (come indicato nel suggerimento per l'accesso), quest'ultimo DEVE mostrare un pulsante "Accedi con Google" affinché l'utente esegua un'azione esplicita dell'utente per attivare la procedura di accesso. Nota: questa operazione è necessaria per rispettare le linee guida per il branding di Google e per evitare blocchi popup. |
OBBLIGATORIO | |
| 2,8 | Il componente aggiuntivo DEVE mostrare chi è l'utente che ha eseguito l'accesso. | CONSIGLIATA | |
| 3,00 | Generali | ||
| 3.1 | Il componente aggiuntivo DEVE rispettare le linee guida generali per l'approvazione di Google Workspace Marketplace. | OBBLIGATORIO | |
| 3.2 | Se un'attività viene avviata in una nuova scheda o finestra da uno qualsiasi dei percorsi dell'iframe, DEVE fornire un messaggio facile da usare per tornare a Classroom. | OBBLIGATORIO | |
| 3,3 | L'utente DEVE completare il percorso solo utilizzando un flusso di lavoro aggiuntivo e non passare a un flusso di lavoro del corso, né utilizzare il pulsante di condivisione di Classroom. | OBBLIGATORIO | |
| 3.4 | Scelta della localizzazione: la lingua DEVE essere basata sulla preferenza locale impostata dal browser, se disponibile. | CONSIGLIATA | |
| 3,5 | Se un componente aggiuntivo definisce maxPoints, DEVE anche impostare pointsEarned quando uno studente completa un invio utilizzando le credenziali dell'insegnante memorizzate (consigliato) OPPURE quando l'insegnante apre i contenuti inviati nell'iframe Revisione del lavoro dello studente. |
OBBLIGATORIO | |
| 3,9 | I componenti aggiuntivi DEVONO essere conformi alle linee guida sull'accessibilità delle linee guida WCAG 2.1 di livello AA. Gli sviluppatori di componenti aggiuntivi segnaleranno autonomamente che questo requisito è soddisfatto al momento dell'invio e che il componente aggiuntivo continua a essere conforme alle future modifiche apportate ai componenti aggiuntivi. | CONSIGLIATA | |
| 3,10 | Gli errori riscontrati da un utente DEVONO essere leggibili. | OBBLIGATORIO | |
| 3,11 | Se studentViewUri, teacherViewUri o studentWorkViewUri viene avviato da un compito copiato o da un corso copiato, il componente aggiuntivo NON DEVE mostrare una pagina di errore nell'iframe. |
OBBLIGATORIO | |
| 3,12 | Se studentViewUri, teacherViewUri o studentWorkViewUri viene avviato da un compito copiato o da 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 a partire da compiti o corsi precedenti. |
CONSIGLIATA | |
| 4,00 | Scoperta degli allegati | ||
| 4,1 | Se un allegato richiede l'invio da parte di uno studente, DEVE includere un studentWorkReviewUri in modo da essere considerato un tipo di attività e non un allegato di tipo contenuto. |
OBBLIGATORIO | |
| 4.2 | L'iframe Attachment Discovery DEVE fornire un'interfaccia utente che offra almeno uno dei seguenti elementi:
|
OBBLIGATORIO | |
| 4.3 | L'insegnante DEVE essere in grado di trovare e accedere a tutti i contenuti/le attività a sua disposizione. | CONSIGLIATA | |
| 4.4 | L'insegnante DEVE essere in grado di visualizzare l'anteprima dei contenuti o dell'attività prima di impegnarsi ad allegarli al compito. | OBBLIGATORIO | |
| 4,5 | Se l'insegnante ha bisogno di lavoro per creare contenuti/attività prima che possano essere allegati, tale lavoro DOVREBBE essere completato nell'iframe. | CONSIGLIATA | |
| 5,0 | Vista studenti | ||
| 5.1 | Quando viene avviato studentViewUri, il componente aggiuntivo NON DEVE Estrarre l'utente dall'iframe per completare un'attività.Se il componente aggiuntivo fa uscire l'utente dall'iframe, DEVE essere presente un messaggio o un'altra indicazione per consentire agli studenti di tornare a Classroom. |
CONSIGLIATA | |
| 5.2 | Se un componente aggiuntivo esce dall'iframe, DEVE essere presente un'anteprima dell'attività nell'iframe. | OBBLIGATORIO | |
| 5.3 | Se un'attività richiede che uno studente intraprenda un'azione per contrassegnare il lavoro come completato, il pulsante NON DEVE essere contrassegnato come "Consegna" per evitare confusione con il pulsante Consegna in Classroom. | OBBLIGATORIO | |
| 6,00 | Vista insegnante | ||
| 6,1 | L'insegnante DEVE essere in grado di vedere ciò che vedrà lo studente quando svolge il compito. | CONSIGLIATA | |
| 7,0 | Revisione del lavoro dello studente | ||
| 7,1 | Se viene lanciato studentWorkReviewUri, il componente aggiuntivo DEVE eseguire il rendering del lavoro dello studente affinché venga esaminato dall'insegnante all'interno dell'iframe. Il materiale supplementare potrebbe rimandare all'esterno dell'iframe. |
OBBLIGATORIO | |
| 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. |
OBBLIGATORIO | |
| 8,0 | Assistenza per Classroom per dispositivi mobili | ||
| 8.1 | Quando l'app mobile Classroom avvia 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, un link diretto alla visualizzazione corretta. Se il dispositivo non è supportato, DEVE essere mostrato all'utente un messaggio per informarlo che si tratta di un dispositivo non supportato e, possibilmente, quali dispositivi sono supportati. |
OBBLIGATORIO | |
| 8.2 | Il lavoro dello studente DOVREBBE essere completato su un dispositivo mobile. | CONSIGLIATA | |
| 9,00 | Altre funzionalità | ||
| 9.1 | Se gli insegnanti possono incollare i link ai tuoi contenuti come allegati dei link, DEVI eseguire l'upgrade dei link ad allegati di componenti aggiuntivi. | CONSIGLIATA | |
| 9.2 | Se utilizzi un'integrazione di CourseWork per creare compiti al di fuori di Classroom, DEVI creare allegati di componenti aggiuntivi per impostazione predefinita per tutti i link compatibili con il componente aggiuntivo. | CONSIGLIATA | |
Log delle modifiche
| Versione 1.0 | Ultimo aggiornamento: 30 aprile 2024 |
| 1.1 | Combinate 1.1 e 1.2 in un unico requisito. |
| 2.1 | Combinazione 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 | Combinato 3.5, 3.6 e 3.7 in un unico requisito. |
| 3,10 | È stato aggiunto il requisito che prevede che il componente aggiuntivo non entri mai in uno stato incomprensibile o non recuperabile. |
| 3,11, 3,12 | Combinato 5.5, 5.6, 6.3, 6.4, 7.5 e 7.6 in due nuovi requisiti. |
| 4.2 | È stata ampliata la descrizione delle esperienze di rilevamento degli allegati accettabili. |
| 4.3 | Rinumerato, in precedenza 4.2. Modificato anche 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 requisito per creare allegati di componenti aggiuntivi per impostazione predefinita durante la creazione programmatica dei compiti di CourseWork. |
| 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 relative al suggerimento per l'accesso. |
| 2.4 | È stato integrato uno scenario in cui è necessario implementare hd. |
| 3.2 | "Fornisci percorso" riformulato. |
| 5,5; 5,6; 6,3; 6,4; 7,5; 7,6 | È stata aggiunta una copia del corso obbligatoria e indicazioni consigliate per
studentViewUri, teacherViewUri e
studentWorkReviewUri. |
| Versione 0.2 | Ultimo aggiornamento: 29 ottobre 2021 |
| 1.3 | Abbiamo modificato il testo per renderlo più chiaro di intento. |
| 3.1 | Aggiunta "Il componente aggiuntivo DEVE rispettare le linee guida generali per l'approvazione di GWM riportate sul relativo sito web". |
| 3,9 | WCAG modificato in REQUIRED in RECOMMENDED. |
| 5.1 | Modificato REQUIRED in CONSIGLIATO. |
| 5.3 | Aggiunta "Se i componenti aggiuntivi escono dall'iframe, DEVONO avere un'anteprima dell'attività nell'iframe". |
| 5,4 | Aggiunta: "Se il componente aggiuntivo esce dall'iframe, DOVREBBE essere chiesto agli studenti di tornare a Classroom". |
| 8.1 | Aggiunta "Se il dispositivo non è supportato, DEVE essere mostrato all'utente un messaggio per comunicare all'utente che si tratta di un dispositivo non supportato e, idealmente, quali dispositivi sono supportati." |
| 8.2 | Il lavoro mobile degli studenti è cambiato da OBBLIGATORIO a CONSIGLIATO. |
| Versione 0.1 | Ultimo aggiornamento: 22 settembre 2021 |
| Release iniziale. |