Os parceiros de SIS interessados podem usar os testes de conformidade no GitHub para determinar se o produto atende aos requisitos de consumo do OneRoster do Google Sala de Aula.
Acessar e executar os testes
Para executar os testes, você precisa do seguinte:
- URL do token para recuperar as credenciais do OAuth 2.0
- URL do OneRoster que termina em
/ims/oneroster/v1p1 - ID do cliente
- Chave secreta do cliente
- Um endereço de e-mail do professor
É possível executar os testes usando o Google Colab ou o notebook Jupyter. O Colab e o Jupyter Notebook permitem executar todos os testes de uma só vez. Isso ajuda a gerar os resultados do teste para compartilhar com a equipe do Google Sala de Aula.
Requisitos e comportamento esperado do SIS
Os testes definidos pelo Google existem para oferecer aos parceiros de sistema de informação escolar interessados uma maneira de determinar se o produto atende aos requisitos de consumo do Google OneRoster e minimizar os erros que os usuários podem encontrar ao usar as integrações do SIS no Google Sala de Aula. Leia as dicas abaixo sobre os testes. No GitHub, cada teste tem um título que é referenciado nos indicadores. Os indicadores podem ajudar a esclarecer as perguntas, mas não são uma lista abrangente dos testes. Verifique se você executou todos os testes fornecidos no GitHub.
| Teste | Ponteiros |
|---|---|
| Professores: GetAllTeachers | O endpoint GET /teachers é chamado com um parâmetro de consulta limit. Em testes subsequentes, esse parâmetro é usado para garantir que o produto ofereça suporte a um tamanho de página de 10.000. |
| Professores: GetAllTeachers com filtro de e-mail | O endpoint GET /teachers é chamado com um parâmetro de consulta filter usado para filtrar com base no endereço de e-mail de um professor. O endereço de e-mail do professor que você informou na seção "Credenciais" dos testes será usado. |
| Classes: GetClassesForTeacher | O endpoint /teachers/{teacher_sourced_id}/classes é chamado com um parâmetro de consulta filter usado para filtrar com base em classes ativas. |
| Alunos: GetStudentsForClass | O endpoint GET /classes/{class_sourced_id}/students é chamado. O e-mail do estudante precisa ser retornado na resposta. |
| GetGradingPeriodsForTerm | O suporte a períodos de avaliação é testado usando o term_sourced_id. Esse term_sourced_id é usado para recuperar os períodos de avaliação no período, chamando o endpoint GET terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Criar | Os períodos de avaliação não são necessários ao chamar PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Editar | A chamada de API não deve retornar um erro se um título de atividade longo for incluído. O teste inclui um título de atividade com mais de 100 caracteres. |
| Resultado: editar | É possível definir score como um valor maior que resultValueMax para representar crédito extra. |
| Resultado: excluir | O endpoint DELETE /results/{result_sourced_id} é obrigatório. |
| LineItem (opcional / limpeza): excluir e receber | O endpoint DELETE /lineItems/{line_item_sourced_id} não é obrigatório. Ele é opcional e usado para limpar dados. O endpoint GET /classes/{class_sourced_id}/lineItems subsequente também é opcional e testa se o item de linha foi excluído. |
Compartilhar os resultados do teste com a equipe do Google Sala de Aula
Depois de executar os 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 tire uma captura de tela do relatório gerado para compartilhar com a equipe do Google Sala de Aula.
Receber suporte
Envie um e-mail para classroom-sis-external@google.com se tiver dúvidas ou problemas.