O Google Sala de Aula aceita a sincronização do boletim de notas e a importação de listas de estudantes para vários sistemas de informações dos estudantes (SIEs) compatíveis com o OneRoster. O Google faz parcerias com plataformas de SIE 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 SIE.
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 do SIE
Se você tiver interesse em fazer parceria com o Google Sala de Aula, preencha o formulário de interesse.
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ê pode executar os testes de conformidade antes de entrar em contato com a equipe do Google Sala de Aula para determinar o quão próximo seu produto está dos requisitos do Google.
Receber um domínio de demonstração para desenvolvedores
Talvez você queira acessar uma instância ativa do Google Sala de Aula para criar e validar uma integração. Os usuários de teste qualificados precisam da edição Plus do Google Workspace for Education. Se você não tiver acesso de administrador a um domínio do Google Workspace for Education com essas licenças, siga as etapas para receber um domínio de teste para desenvolvedores e solicitar um upgrade de domínio de demonstração. Seu domínio será provisionado com 10 licenças do Google Workspace for Education Plus.
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/v1p2 - ID do cliente
- Chave secreta do cliente
- Um endereço de e-mail de professor
Você pode executar os testes usando o Google Colab ou o Jupyter Notebook. 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 SIE
Os testes definidos pelo Google existem para oferecer aos parceiros de SIE interessados uma maneira de determinar se o produto deles atende aos requisitos de consumo do OneRoster do Google e para minimizar os erros que os usuários podem encontrar ao usar integrações de SIE no Google Sala de Aula. Leia os seguintes indicadores sobre os testes. No GitHub, cada teste tem um título referenciado nos indicadores. Os indicadores podem ajudar a esclarecer dúvidas, mas não são uma lista abrangente dos testes. Execute todos os testes fornecidos no GitHub.
| Teste | Indicadores |
|---|---|
| Professores: GetAllTeachers | O endpoint GET /teachers é chamado com um parâmetro de consulta limit. Em testes subsequentes, esse parâmetro é usado para garantir que seu produto possa oferecer 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 em um endereço de e-mail de professor. Isso vai usar o endereço de e-mail do professor fornecido na seção "Credenciais" dos testes. |
| Turmas: GetClassesForTeacher | O endpoint /teachers/{teacher_sourced_id}/classes é chamado com um parâmetro de consulta filter usado para filtrar com base em turmas 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. Este 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: Create | Os períodos de avaliação não são necessários ao chamar PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | 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. |
| Result: Edit | É possível definir a score como um valor maior que resultValueMax para representar crédito extra. |
| Result: Delete | O endpoint DELETE /results/{result_sourced_id} é obrigatório. |
| LineItem (opcional / revisão dos dados): Delete and Get | O endpoint DELETE /lineItems/{line_item_sourced_id} não é obrigatório. Ele é opcional e usado para limpeza de 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 uma captura de tela do relatório gerado para compartilhar com seus contatos na equipe do Google Sala de Aula.