Per integrare il tuo SIS con Classroom, verifica che il tuo prodotto sia conforme ai requisiti di partnership di Classroom eseguendo l'insieme di test di conformità fornito.
Accedere ed eseguire i test
Puoi accedere ai test di conformità su GitHub. Per eseguire i test, hai bisogno di quanto segue:
- URL del token per recuperare le credenziali OAuth 2.0
- URL di OneRoster che termina con
/ims/oneroster/v1p1 - ID client
- Client secret
- Un indirizzo email dell'insegnante
La suite di test è composta da tre sezioni:
- Sincronizzazione dei voti di base
- Categorie di valutazione
- Periodi di valutazione
Puoi eseguire i test utilizzando Google Colab o Jupyter Notebook. Colab e blocco note Jupyter consentono di eseguire tutti i test contemporaneamente. In questo modo puoi generare i risultati del test da condividere con il team di Google Classroom.
Requisiti del SIS e comportamento previsto
I test definiti da Google esistono per mantenere la coerenza e ridurre al minimo gli errori che gli utenti potrebbero riscontrare quando utilizzano le integrazioni del SIS con Classroom. Leggi i seguenti suggerimenti sui test. In GitHub, ogni test ha un titolo a cui viene fatto riferimento nei puntatori. Tieni presente che i suggerimenti possono aiutarti a chiarire le domande, ma non sono un elenco esaustivo dei test. Assicurati di aver eseguito tutti i test forniti in GitHub.
Sincronizzazione dei voti di base
| Test | Indicatori |
|---|---|
| Insegnanti: GetAllTeachers | L'endpoint GET /teachers viene chiamato con un parametro di query limit. Nei test successivi, questo parametro viene utilizzato per assicurarsi che il prodotto possa supportare una dimensione di pagina di 10.000. |
| Insegnanti: GetAllTeachers con filtro email | L'endpoint GET /teachers viene chiamato con un parametro di ricerca filter utilizzato per filtrare in base all'indirizzo email di un insegnante. Verrà utilizzato l'indirizzo email dell'insegnante che hai fornito nella sezione Credenziali dei test. |
| Classi: GetClassesForTeacher | L'endpoint /teachers/{teacher_sourced_id}/classes viene chiamato con un parametro di query filter utilizzato per filtrare in base ai corsi attivi. |
| Studenti: GetStudentsForClass | Viene chiamato l'endpoint GET /classes/{class_sourced_id}/students. L'email dello studente deve essere restituita nella risposta. |
| LineItem: Create | Le categorie di valutazione o i periodi di valutazione non sono obbligatori quando chiami PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | La chiamata all'API non deve restituire un errore se è inclusa una lunghezza del titolo del compito lunga. Il test include un titolo del compito di almeno 100 caratteri. |
| Risultato: Modifica | Dovrebbe essere possibile impostare score su un valore maggiore di resultValueMax per rappresentare il merito aggiuntivo. |
| Risultato: elimina | L'endpoint DELETE /results/{result_sourced_id} è obbligatorio. |
| LineItem (facoltativo / pulizia): elimina ed esegui Get | L'endpoint DELETE /lineItems/{line_item_sourced_id} non è obbligatorio. È facoltativo e viene utilizzato per la pulizia dei dati. Anche l'endpoint GET /classes/{class_sourced_id}/lineItems successivo è facoltativo e verifica che l'elemento pubblicitario sia stato eliminato. |
Categorie di valutazione
| Test | Indicatori |
|---|---|
| GetAllCategories o GetCategoriesForClass | È obbligatorio un solo endpoint GET /categories, GetAllCategories o GetCategoriesForClass. Se esegui tutti i test contemporaneamente, commenta quello che non utilizzi. |
| DeleteLineItem (facoltativo / pulizia) | Il test DeleteLineItem è facoltativo e può essere utilizzato per la pulizia dei dati. |
Periodi di valutazione
| Test | Puntatori |
|---|---|
| GetGradingPeriodsForTerm | Il supporto dei periodi di valutazione viene testato recuperando term_sourced_id nel test GetAllClasses con filtro. Questo term_sourced_id viene utilizzato per recuperare i periodi di valutazione nel trimestre chiamando l'endpoint GET terms/{term_sourced_id}/gradingPeriods nel test GetGradingPeriodsForTerm. |
Condividere i risultati del test con il team di Google Classroom
Dopo aver eseguito i test, viene generato un report completo con i risultati di ciascun test. Questi test vengono utilizzati per determinare se il tuo prodotto soddisfa i requisiti di consumo di Google OneRoster 1.1. Scarica o acquisisci uno screenshot del report generato. Invia il report via email e un link alla certificazione OneRoster 1.1 del tuo prodotto all'indirizzo classroom-sis-external@google.com.
Assistenza
In caso di domande o dubbi, invia un'email all'indirizzo classroom-sis-external@google.com.