As atividades no Google Sala de Aula são chamadas de itens de atividades do curso, que podem ser encontrados na página "Atividades" de qualquer curso do Google Sala de Aula. Embora haja quatro tipos de itens do Trabalho da turma, este guia se concentra apenas no tipo "Atividade". Se quiser saber como gerenciar os outros tipos de atividades do Google Sala de Aula, leia nosso guia de gerenciamento do Google Sala de Aula.
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 Google Classroom. O botão de compartilhamento permite que os usuários compartilhem conteúdo como qualquer item do mural em uma caixa de diálogo pop-up do Google Sala de Aula. Já a API Classroom permite um fluxo de trabalho de atividades do início ao fim, incluindo a criação de atividades, a criação e o gerenciamento de envios dos estudantes e a devolução de notas.
Aqui, vamos analisar as principais diferenças entre essas duas ofertas para desenvolvedores. Mais especificamente, vamos trabalhar com as diferenças na implementação e em cada fase do ciclo de vida da atividade: criação, envio dos estudantes e avaliação/feedback.
Entender o ciclo de vida das atividades
Antes de passar para as diferenças entre o botão de compartilhamento e a API CourseWork, vamos definir o que consideramos o ciclo de vida de uma atividade no contexto do Google Sala de Aula. Isso vai ajudar você a entender como professores e estudantes interagem com as atividades no Google Sala de Aula.
Há cinco etapas principais a serem consideradas ao fazer a integração com as atividades do Google Sala de Aula:
- A atividade é criada.
- A atividade é compartilhada com os estudantes.
- O estudante conclui a atividade.
- O estudante envia a atividade ao professor.
- O professor revisa e atribui notas às 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 sem problemas. Em vez de gerenciar os detalhes de uma atividade ou os envios dos estudantes, os usuários podem contar com seu aplicativo para gerenciar esses detalhes.
Implementação
A primeira diferença entre o botão de compartilhamento e a API CourseWork é a implementação. Do ponto de vista do desenvolvedor, o botão de compartilhamento é um método mais fácil de compartilhar conteúdo no Google Sala de Aula, já que só exige incluir o recurso JavaScript necessário e adicionar uma tag de botão de compartilhamento. 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>
Por outro lado, a API CourseWork faz parte da API REST do Google Classroom, que exige a configuração e ativação de chaves de API com o console do Google Cloud e o seguimento das práticas recomendadas para integração com uma API. Isso é menos preocupante se a plataforma já estiver usando outras funcionalidades da API Classroom, como criação de listas.
Criar e compartilhar atividades
Embora o botão de compartilhamento e a API CourseWork permitam as duas primeiras etapas do fluxo de trabalho de atividades, ou seja, criar e compartilhar a atividade com os estudantes, há algumas diferenças importantes que você precisa considerar antes de escolher uma solução.
Basicamente, as duas soluções permitem postar links ou arquivos como atividades no Google Sala de Aula. Isso serve como um fluxo de trabalho eficiente para professores que, de outra forma, seriam obrigados a copiar e colar entre o Google Sala de Aula e o aplicativo de terceiros. Embora as duas soluções ofereçam suporte à capacidade de postar conteúdo como uma atividade, considere se seu aplicativo precisa da flexibilidade de postar esse conteúdo como outros tipos do Google Sala de Aula ou até mesmo um aviso.
Ambas as ofertas expõem todos os tipos de postagens do Google Sala de Aula, exceto as atividades de teste. Confira abaixo um resumo de todos os tipos de postagens e se elas são 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 |
| Anúncio | X | X |
A funcionalidade, como especificar título e descrição, também pode ser especificada programaticamente pelo aplicativo para ambas as soluções. Embora a integração do botão de compartilhamento permita que os usuários definam campos como data de entrega, tema, modo individualizado e número de pontos na caixa de diálogo pop-up, eles não podem ser definidos programaticamente por um app de terceiros. Por outro lado, a API expõe todos esses campos para acesso de leitura e gravação.
Modificar atribuições
Eliminar a necessidade de os usuários sincronizarem manualmente os detalhes das atividades é um dos benefícios da integração com a API Classroom. O botão "Compartilhar" não tem funcionalidade para atualizar ou excluir atividades de maneira programática. Portanto, as modificações necessárias precisam ser feitas pelo usuário na interface do Google Sala de Aula.
Com a API CourseWork, é possível modificar e excluir atividades criadas pelo aplicativo, além de recuperar detalhes de qualquer atividade postada nos cursos do usuário. No entanto, é importante observar que os itens do Trabalho da Turma não criados pelo mesmo console de desenvolvedor não podem ser modificados por ele. Esse modelo de permissão se estende ao restante do ciclo de vida da atividade. Por exemplo, o gerenciamento de envios e notas dos estudantes não pode ser acessado para esses itens do Google Atividades.
Sincronizar atividades 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 Atividade e nos envios dos estudantes associados. Isso permite que seu aplicativo sincronize atividades com facilidade, eliminando a necessidade de verificações contínuas para saber se o conteúdo foi atualizado no Google Sala de Aula.
Concluir e enviar atividades
Cada atividade está associada a N envios de estudantes, em que N é o número de estudantes a quem a atividade foi atribuída. Em outras palavras, para cada atividade, há um envio de um 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 de envios dos estudantes.
O botão de compartilhamento e a API CourseWork permitem adicionar links ou arquivos ao envio de uma atividade por um estudante. O botão de compartilhamento permite isso com um fluxo de trabalho semelhante à caixa de diálogo de criação de atividades do professor e à API CourseWork pelo endpoint studentSubmissions.modifyAttachments. No entanto, devido às restrições de permissão da API detalhadas anteriormente, essa funcionalidade é limitada aos itens de atividades criados pelo seu aplicativo. Essa mesma restrição não se aplica ao botão de compartilhamento. Os estudantes podem adicionar o trabalho deles a qualquer atividade selecionada na Sala de Aula.
Como encerrar o fluxo de trabalho do estudante
Embora a restrição de permissão do CourseWork não sirva 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 a atividade errada e se esqueçam de entregar o trabalho, já que apenas o botão de compartilhamento é limitado para que os estudantes entreguem as atividades.
Revisar e dar notas em atividades
A última parte do ciclo de vida da atividade volta para o professor. Depois que os estudantes entregam a atividade, o professor pode revisar da maneira que achar mais adequada. No caso de arquivos armazenados no Drive, eles podem revisar diretamente no corretor do Google Sala de Aula. No entanto, não é possível acessar aplicativos de terceiros no classificador do Google Sala de Aula. A implicação dessa experiência é que os professores precisam navegar por várias guias ao revisar e corrigir atividades.
No momento, o botão de compartilhamento não oferece uma solução para classificar e devolver atividades. Embora recursos como comentários de envio dos estudantes não estejam expostos pela API no momento, é possível atribuir notas e devolvê-las aos estudantes usando os endpoints studentSubmissions.patch e studentSubmissions.return. As notas só podem ser especificadas para itens do fluxo de atividades do curso (tipos Atividade e Pergunta). Elas estão disponíveis apenas em formato numérico e podem ser atribuídas como uma nota provisória ou final.
Resumo das diferenças
Para resumir tudo o que foi analisado 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 revisão e avaliação de atividades.
| Botão Compartilhar | API CourseWork | |
|---|---|---|
| Implementação | Apenas algumas linhas de JavaScript, o que torna a implementação simples e rápida | Requer a configuração de chaves de API, a ativação de APIs no Admin Console e um monitoramento mais próximo. |
| Criar e compartilhar atividades |
|
|
| Concluir e enviar atividades |
|
|
| Revisar e atribuir nota às atividades | Não há suporte para especificar ou retornar notas |
|