Como contornamos as restrições da API do Google Classroom para reduzir a frustração e trazer clareza a fluxos educacionais em larga escala
2025
Contexto
O orchestra4edu é uma plataforma B2B SaaS que integra o Google Workspace com ERPs e outras plataformas educacionais, estendendo o Google Classroom para funcionar como um LMS completo. Um dos recursos centrais do seu painel administrativo é o Design de Aprendizagem, onde a equipe escolar monta trilhas de aprendizagem, conjuntos de atividades e materiais organizados para guiar os estudantes ao longo do semestre. Ao finalizar uma trilha, o sistema publica ou cria rascunhos de todo esse conteúdo no Google Classroom, de uma vez, para múltiplas turmas.
Problema
A publicação acontecia via API do Google Classroom, e a API simplesmente não suporta ordenação de conteúdo. Isso significa que, depois de publicado, o material chegava nas turmas fora da sequência planejada pela equipe pedagógica. A trilha tinha uma lógica, uma progressão pensada, e essa progressão desaparecia no momento em que o conteúdo era enviado.
O impacto era duplo: os estudantes perdiam a ordem correta de consumo dos materiais, e os administradores perdiam a confiança no sistema. O que estava desenhado na plataforma e o que aparecia no Google Classroom não batiam, e isso criava uma sensação constante de que algo tinha dado errado.
Processo de Design
A primeira tentativa de qualquer time seria tentar corrigir a ordem depois da publicação, só que a API também não permitia reorganizar conteúdo já publicado. Ou seja, o problema não tinha solução direta simples do lado técnico.
Isso deslocou o foco do resultado para o processo. Se não dava para garantir a ordem depois, precisávamos garantir a ordem durante, e deixar isso transparente para quem estava publicando. A lógica que encontramos foi tratar a publicação como uma fila controlada: o sistema enviava os itens um a um, na sequência definida, aproveitando que o Google Classroom ordena o conteúdo por data e hora de criação. Publicar em sequência significava que a ordem de chegada seria a ordem planejada.
Mas só resolver tecnicamente não bastava. O administrador precisava entender o que ia acontecer antes de apertar o botão. Por isso, a outra parte do trabalho foi tornar a estrutura explícita na interface: mostrar claramente a sequência em que o conteúdo seria publicado, usar os Tópicos nativos do Google Classroom como camada de categorização visível ainda dentro da plataforma, e comunicar o comportamento esperado de forma que o usuário chegasse ao resultado sem surpresas.
Resultado
A mudança eliminou a dissonância entre o que o administrador desenhava e o que aparecia no Google Classroom. A equipe escolar passou a publicar trilhas com confiança de que a estrutura seria respeitada, e os estudantes passaram a receber o conteúdo na ordem correta. Num produto voltado para grandes instituições de ensino, onde uma trilha pode ser publicada em dezenas de turmas ao mesmo tempo, previsibilidade não é um detalhe de experiência, é um requisito operacional.