O Google Sala de Aula oferece suporte à sincronização do boletim de notas e à importação de listas de estudantes para vários sistemas de informações de estudantes (SIEs) compatíveis com o OneRoster. O Google faz parcerias com plataformas de SIA que atendem aos requisitos do OneRoster especificados pelo Google.
A parceria com o Google Sala de Aula permite que os administradores conectem as turmas do Google Sala de Aula ao seu SIA.
Figura 1. Quando os sistemas de informações dos estudantes (SIEs) fazem parceria com o Google Sala de Aula, os administradores podem escolher o SIE no menu suspenso.
Jornada de desenvolvimento de parceiros de SIA
Se você tiver interesse em fazer parceria com o Google Sala de Aula, entre em contato com classroom-sis-external@google.com para saber mais.
A equipe do Google Sala de Aula criou um conjunto de testes de conformidade que os parceiros de SIE interessados podem usar para se familiarizar com os requisitos do Google. Você tem a opção de executar os testes de conformidade antes de entrar em contato com a equipe do Google Sala de Aula para determinar o quanto seu produto atende aos requisitos do Google.
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 extrair 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.2 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.