As atividades no Google Sala de Aula são chamadas de itens do curso e podem ser encontradas na página "Atividades" de qualquer curso do Google Sala de Aula. Existem quatro tipos de itens na página "Atividades", mas este guia se concentra apenas no tipo "Atividade". Para saber como gerenciar os outros tipos de atividades, leia nosso guia "Gerenciar atividades".
O Google Sala de Aula tem duas maneiras de se integrar a um fluxo de trabalho de atividades: o botão de compartilhamento do Google Sala de Aula e a API Classroom. Com o botão de compartilhamento, os usuários podem compartilhar conteúdo como qualquer item do stream em uma caixa de diálogo pop-up do Google Sala de Aula. Já a API Classroom permite um fluxo de trabalho de atribuição do início ao fim, que inclui a criação de atividades, a criação e o gerenciamento de envios de estudantes e o envio de notas.
Aqui vamos analisar as principais diferenças entre as duas ofertas para desenvolvedores. Mais especificamente, abordaremos as diferenças na implementação e em cada fase do ciclo de vida da tarefa: criação de atividades, envio de alunos e avaliação/feedback.
Entenda o ciclo de vida da atribuição
Antes de falar sobre as diferenças entre o botão de compartilhamento e a API CourseWork, vamos primeiro definir o que consideramos ser o ciclo de vida de uma atividade no contexto do Google Sala de Aula. Isso ajuda você a entender como professores e estudantes interagem com as atividades no Google Sala de Aula.
Você precisa ter cinco etapas principais em mente ao fazer a integração com as atividades do Google Sala de Aula:
- A atividade foi criada.
- A atividade foi compartilhada com os estudantes.
- O estudante conclui a atividade.
- O estudante envia a atividade para o professor.
- As avaliações dos professores e as notas das atividades
A integração com as atividades do Google Sala de Aula permite que professores e estudantes trabalhem entre o Google Sala de Aula e aplicativos de terceiros com facilidade. Em vez de gerenciar os detalhes de uma atividade ou os envios dos estudantes, os usuários podem confiar no seu aplicativo para gerenciar esses detalhes.
Implementação
A primeira diferença entre o botão de compartilhamento e a API CourseWork é a implementation. Do ponto de vista do desenvolvedor, o botão de compartilhamento é um método fácil de compartilhar conteúdo no Google Sala de Aula, porque exige apenas a inclusão do recurso JavaScript necessário e a adição de uma tag desse botão. Na forma mais simples, a integração do botão de compartilhamento do Google Sala de Aula pode ser parecida com o snippet abaixo:
<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>
A API CourseWork, por outro lado, faz parte da API REST da API Google Classroom, que exige a configuração e a ativação de chaves de API com o console do Google Cloud e seguir as práticas recomendadas para integração com uma API. Isso não será um problema se sua plataforma já usar outras funcionalidades da API Classroom, como a lista de estudantes.
Criar e compartilhar atividades
Embora o botão de compartilhamento e a API CourseWork permitam as duas primeiras etapas do fluxo de trabalho da atividade, criar e compartilhar a atividade com os alunos, há algumas diferenças importantes que precisam ser consideradas antes de escolher uma solução.
Basicamente, as duas soluções permitem postar links ou arquivos como atribuições no Google Sala de Aula. Isso serve como um fluxo de trabalho avançado para os professores que seriam obrigados a copiar e colar entre o Google Sala de Aula e o aplicativo de terceiros. Embora as duas soluções permitam postar conteúdo como uma atividade, considere se a inscrição precisa da flexibilidade de postar o conteúdo como outros tipos de atividades ou até mesmo um anúncio.
As duas ofertas exibem todos os tipos de postagem do Google Sala de Aula, exceto as atividades com teste. Confira abaixo um resumo de todos os tipos de postagem e saber se elas foram expostas.
| Tipo de postagem | Botão "Compartilhar" | API CourseWork |
|---|---|---|
| Atribuição | X | X |
| Atividade com teste | ||
| Pergunta: resposta curta | X | X |
| Pergunta: múltipla escolha | X | X |
| Material | X | X |
| Aviso | X | X |
Recursos como especificar o título e a descrição também podem ser especificados programaticamente pelo aplicativo para as duas soluções. Embora a integração do botão de compartilhamento permita que os usuários definam campos como data de conclusão, tema, modo individual e número de pontos na caixa de diálogo pop-up, eles não podem ser definidos programaticamente por um app de terceiros. A API, por outro lado, expõe todos esses campos para acesso de leitura e gravação.
Modificar atribuições
Um dos benefícios da integração com a API Classroom é eliminar a necessidade de os usuários sincronizarem manualmente as mudanças em detalhes das atribuições. O botão de compartilhamento não tem a funcionalidade de atualizar ou excluir atividades de forma programática. Por isso, qualquer modificação necessária precisa ser feita pelo usuário na interface do Google Sala de Aula.
Com a API CourseWork, é possível modificar e excluir as atividades criadas pelo app e recuperar detalhes sobre as atividades postadas nos cursos do usuário. No entanto, é importante observar que os itens do CourseWork não criados pelo mesmo console do desenvolvedor não podem ser modificados por esse console. Esse modelo de permissão se estende ao restante do ciclo de vida da atividade, por exemplo, ao gerenciar envios e notas dos estudantes, não pode ser acessado para esses itens do CourseWork.
Sincronizar atribuições automaticamente
Com as notificações push do Pub/Sub, seu aplicativo pode se inscrever para receber notificações que acionam um evento quando há mudanças nos itens do CourseWork e nos envios associados dos alunos. Isso facilita que o app sincronize as atividades, eliminando a necessidade de verificações contínuas para confirmar se o conteúdo foi atualizado no Google Sala de Aula.
Como concluir e enviar atividades
Cada atividade é associada a N envios de estudantes, em que N é o
número de estudantes a que a atividade foi atribuída. Em outras palavras, para cada
atividade, há um envio de estudante associado a cada estudante, que
pode ser acessado com um ID exclusivo. Esses envios dos estudantes são criados
automaticamente e podem ser recuperados pelo aplicativo com os endpoints
GET e LIST dos envios de alunos.
Com o botão de compartilhamento e a API CourseWork, é possível adicionar links ou arquivos ao envio de uma atividade por um estudante. O botão "Compartilhar" permite fazer isso usando um fluxo de trabalho semelhante ao da caixa de diálogo de criação de atividades do professor, e a API CourseWork pelo endpoint studentSubmissions.modifyAttachments. No entanto, devido às restrições de permissão da API detalhadas anteriormente, essa funcionalidade é limitada aos itens do CourseWork criados pelo seu aplicativo. Essa mesma restrição não se aplica ao botão de compartilhamento: os estudantes podem adicionar o trabalho a qualquer atividade que selecionarem no Google Sala de Aula.
Como encerrar o fluxo de trabalho do estudante
Embora a restrição de permissão do CourseWork não sirva a um caso de uso para plataformas que não oferecem suporte à criação de atividades, um benefício é que as plataformas de terceiros podem impedir que os estudantes enviem para a atividade incorreta e se esqueçam de entregar o trabalho, já que apenas o botão "Compartilhar" é limitado à capacidade dos estudantes de entregar as atividades.
Avaliar e dar nota às atividades
A última parte do ciclo de vida da tarefa volta para o professor. Depois que os estudantes entregam a atividade, o professor pode revisar a atividade da forma mais adequada. No caso de arquivos armazenados no Google Drive, eles podem ser revisados diretamente no avaliador do Google Sala de Aula. No entanto, os aplicativos de terceiros não podem ser acessados na ferramenta de notas do Google Sala de Aula. A implicação dessa experiência é que os professores precisam navegar em várias guias durante a revisão e avaliação das atividades.
No momento, o botão de compartilhamento não oferece uma solução para avaliar e devolver atividades. Ainda que recursos como comentários enviados pelos estudantes não estejam expostos na API, é possível avaliar e devolver essas notas aos estudantes usando os endpoints studentSubmissions.patch e studentSubmissions.return. As notas só podem ser especificadas para itens do fluxo do CourseWork (tipos de atividades e perguntas). Elas estão disponíveis apenas em formato numérico e podem ser atribuídas como rascunho ou nota final.
Resumo das diferenças
Para resumir tudo que foi abordado nas seções anteriores, a tabela abaixo mostra uma comparação lado a lado do botão de compartilhamento e da API CourseWork para as quatro categorias discutidas acima: implementação, criação e compartilhamento de atividades, conclusão e envio de atividades e avaliação e avaliação de atividades.
| Botão Compartilhar | API CourseWork | |
|---|---|---|
| Implementação | Apenas algumas linhas de JavaScript, o que torna a implementação direta e rápida | Exige a configuração de chaves de API, a ativação de APIs no Admin Console e o monitoramento mais detalhado |
| Criação e compartilhamento de atribuições |
|
|
| Conclusão e envio de tarefas |
|
|
| Avaliar e dar nota às atividades | Não há suporte para especificar ou retornar notas. |
|