O Google Sala de Aula oferece suporte à sincronização de boletins e à importação de listas de estudantes para vários sistemas de informações de estudantes (SIE) 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 (SIE) fazem parceria com o 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 uma 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 parceiros interessados do SIE 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 quanto seu produto atende aos 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 de desenvolvedor e solicitar um upgrade de domínio de demonstração. Seu domínio vai receber 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 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 de professor
É possível executar os testes usando o Google Colab ou o notebook Jupyter. Com o Colab e o notebook Jupyter, é possível 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 interessados do SIA uma maneira de determinar se o produto deles atende aos requisitos de consumo do OneRoster do Google e minimizar os erros que os usuários podem encontrar ao usar as integrações do SIA no Google Sala de Aula. Leia as dicas a seguir sobre os testes. No GitHub, cada teste tem um título referenciado nos ponteiros. 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 | 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 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 que você forneceu na seção "Credenciais" dos testes. |
| Classes: GetClassesForTeacher | O endpoint /teachers/{teacher_sourced_id}/classes é chamado com um parâmetro de consulta filter usado para filtrar com base nas aulas ativas. |
| Estudantes: 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 letivo chamando o endpoint GET terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | Os períodos de avaliação não são obrigatórios ao chamar PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | A chamada de API não pode 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 o score como um valor maior que o resultValueMax para representar um 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. É 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. |
Compartilhe 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 um deles será 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 a equipe do Google Sala de Aula.
Receber suporte
Envie um e-mail para classroom-sis-external@google.com se tiver dúvidas.