Per integrare il SIS con Classroom, verifica che il tuo prodotto soddisfi i 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, devi avere quanto segue:
- URL del token per recuperare le credenziali OAuth 2.0
- Un URL dell'elenco che termina con
/ims/oneroster/v1p1
- ID client
- Client secret
- L'indirizzo email di un insegnante
La suite di test è composta da tre sezioni:
- Sincronizzazione dei voti di base
- Categorie di voto
- Periodi di valutazione
Puoi eseguire i test utilizzando Google Colab o il blocco note Jupyter. I blocchi note Colab e Jupyter ti 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 servono a mantenere la coerenza e ridurre al minimo gli errori che gli utenti potrebbero riscontrare durante l'utilizzo delle integrazioni dei SIS con Classroom. Leggi attentamente i seguenti suggerimenti sui test. In
GitHub, ogni test è contrassegnato con @title
. Questi titoli sono indicati
nei puntatori.
Tieni presente quanto segue in merito alla sezione Sincronizzazione dei voti di base:
Nel test
GetAllTeachers
, l'endpointGET /teachers
viene chiamato con un parametro di querylimit=
. Nei test successivi, questo parametro viene utilizzato per verificare che il tuo prodotto possa supportare una dimensione di pagina pari a 10.000.Nel test
GetAllTeachers with email filter
, l'endpointGET /teachers
viene richiamato con un parametro di queryfilter=
utilizzato per filtrare in base all'indirizzo email dell'insegnante. Devi specificare l'indirizzo email di un insegnante quando esegui i test.Nel test
GetClassesForTeacher
, l'endpoint/teachers/{teacher_sourced_id}/classes
viene chiamato con un parametro di queryfilter=
utilizzato per filtrare in base alle classi attive.Nel test
GetStudentsForClass
viene chiamato l'endpointGET /classes/{class_sourced_id}/students?limit=10000
. L'indirizzo email dello studente deve essere restituito nella risposta.Nel test
PutLineItem Create
, le categorie di voto o i periodi di valutazione non sono obbligatori quando chiamiPUT /lineItems/{line_item_sourced_id}
.Nel test
PutLineItem Edit
, la chiamata API non deve restituire un errore se è incluso un titolo di compito lungo. Il test include un titolo del compito di più di 100 caratteri.Nel test
PutResult Edit
dovrebbe essere possibile impostarescore
su un valore maggiore diresultValueMax
per rappresentare il merito aggiuntivo.L'endpoint
DELETE /results/{result_sourced_id}
è obbligatorio e testato nel testDeleteResult
.L'endpoint
DELETE /lineItems/{line_item_sourced_id}
non è obbligatorio. È facoltativo e viene utilizzato per la pulizia dei dati.
Tieni presente quanto segue riguardo alle sezioni Categorie di voto e Periodi di valutazione:
- È richiesto un solo endpoint
GET /categories
. Commenta quello che non utilizzi se esegui tutti i test di conformità contemporaneamente:/categories?limit=10000
/classes/{class_sourced_id}/categories?limit=10000
- Il supporto dei periodi di valutazione viene testato recuperando il
term_sourced_id
nel testGetAllClasses w/ filter
. Questoterm_sourced_id
viene utilizzato per recuperare i periodi di valutazione nel termine chiamando l'endpointGET terms/{term_sourced_id}/gradingPeriods?limit=10000
nel testGetGradingPeriodsForTerm
.
- È richiesto un solo endpoint
Condividi i risultati del test con il team di Google Classroom
Dopo aver eseguito i test, viene generato un report completo con i risultati di ogni test. Questi test vengono utilizzati per determinare se il tuo prodotto soddisfa i requisiti di consumo di OneRoster 1.1 di Google. 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
Invia un'email a classroom-sis-external@google.com per qualsiasi domanda o dubbio.