Verificar se o SIA atende aos requisitos do Google Sala de Aula

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.

  1. Observações sobre a seção Sincronização básica de notas:

    • No teste GetAllTeachers, o endpoint GET /teachers é chamado com um parâmetro de consulta limit=. 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 endpoint GET /teachers é chamado com um parâmetro de consulta filter= 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 consulta filter= usado para filtrar com base nas classes ativas.

    • No teste GetStudentsForClass, o endpoint GET /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 chamar PUT /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 definir score como um valor maior que resultValueMax para representar o crédito extra.

    • O endpoint DELETE /results/{result_sourced_id} é obrigatório e testado no teste DeleteResult.

    • O endpoint DELETE /lineItems/{line_item_sourced_id} não é obrigatório. É opcional e usado para limpeza de dados.

  2. 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 teste GetAllClasses w/ filter. A term_sourced_id é usada para recuperar os períodos de avaliação do termo chamando o endpoint GET terms/{term_sourced_id}/gradingPeriods?limit=10000 no teste GetGradingPeriodsForTerm.

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.