Para integrar seu SIA ao Google Sala de Aula, verifique se seu produto atende aos requisitos de parceria do Google Sala de Aula executando o conjunto fornecido de testes de conformidade.
Acessar e executar os testes
Acesse os testes de conformidade (link em inglês) no GitHub. Para executar os testes, você precisa do seguinte:
- URL do token para recuperar credenciais do OAuth 2.0
- URL da lista de estudantes que termina em
/ims/oneroster/v1p1
- ID do cliente
- Chave secreta do cliente
- O endereço de e-mail de um professor
Há três seções no pacote de testes:
- Sincronização de notas básica
- Categorias de notas
- Períodos de avaliação
É possível executar os testes usando o Google Colab ou o notebook Jupyter. O Colab e o notebook Jupyter permitem que você execute todos os testes de uma só vez. Isso ajuda você a gerar os resultados do teste para compartilhar com a equipe do Google Sala de Aula.
Requisitos do SIA e comportamento esperado
Os testes definidos pelo Google existem para manter a consistência e minimizar
os erros que os usuários podem enfrentar ao utilizar as integrações do SIA com o
Google Sala de Aula. Leia os ponteiros abaixo sobre os testes. No
GitHub, cada teste é marcado com @title
. Esses títulos são referenciados nos
ponteiros.
Observações sobre a seção Sincronização básica de notas:
No teste
GetAllTeachers
, o endpointGET /teachers
é chamado com um parâmetro de consultalimit=
. Nos testes subsequentes, esse parâmetro é usado para garantir que seu produto ofereça suporte a um tamanho de página de 10.000.No teste
GetAllTeachers with email filter
, o endpointGET /teachers
é chamado com um parâmetro de consultafilter=
usado para filtrar com base no endereço de e-mail do professor. É necessário especificar um endereço de e-mail de professor ao executar os testes.No teste
GetClassesForTeacher
, o endpoint/teachers/{teacher_sourced_id}/classes
é chamado com um parâmetro de consultafilter=
usado para filtrar com base nas classes ativas.No teste
GetStudentsForClass
, o endpointGET /classes/{class_sourced_id}/students?limit=10000
é chamado. O e-mail do estudante precisa ser devolvido na resposta.No teste
PutLineItem Create
, as categorias de notas ou os períodos de avaliação não são obrigatórios ao chamarPUT /lineItems/{line_item_sourced_id}
.No teste
PutLineItem Edit
, a chamada de API não retornará um erro se um título de atribuição longo for incluído. O teste inclui um título de atribuição com mais de 100 caracteres.No teste de
PutResult Edit
, é possível definirscore
como um valor maior queresultValueMax
para representar o crédito extra.O endpoint
DELETE /results/{result_sourced_id}
é obrigatório e testado no testeDeleteResult
.O endpoint
DELETE /lineItems/{line_item_sourced_id}
não é obrigatório. É opcional e usado para limpeza de dados.
Observe o seguinte sobre as seções Categorias de notas e Períodos de avaliação:
- Apenas um endpoint
GET /categories
é obrigatório. Comente aquele que você não vai usar se estiver executando todos os testes de conformidade de uma só vez:/categories?limit=10000
/classes/{class_sourced_id}/categories?limit=10000
- A compatibilidade com os períodos de avaliação é testada recuperando o
term_sourced_id
no testeGetAllClasses w/ filter
. Aterm_sourced_id
é usada para recuperar os períodos de avaliação do termo chamando o endpointGET terms/{term_sourced_id}/gradingPeriods?limit=10000
no testeGetGradingPeriodsForTerm
.
- Apenas um endpoint
Compartilhar os resultados do teste com a equipe do Google Sala de Aula
Após a execução dos testes, um relatório completo com os resultados de cada teste é gerado. Esses testes são usados para determinar se o produto atende aos requisitos de consumo do OneRoster 1.1 do Google. Faça o download ou faça uma captura de tela do relatório gerado. Envie o relatório e um link para a certificação do OneRoster 1.1 do produto por e-mail para classroom-sis-external@google.com.
Receber suporte
Envie um e-mail para classroom-sis-external@google.com com suas dúvidas.