As atividades no Google Sala de Aula são chamadas de itens de atividades da turma, que podem ser encontrados na página "Atividades" de qualquer curso do Google Sala de Aula. Embora existam quatro tipos de itens de atividades, este guia se concentra apenas no tipo "Atividade". Se você quiser saber como gerenciar os outros tipos de atividades, leia nosso guia de gerenciamento de 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 Google Sala de Aula. O botão de compartilhamento permite que os usuários compartilhem conteúdo como qualquer item de transmissão por meio de uma caixa de diálogo pop-up do Google Sala de Aula. Já a API Classroom permite um fluxo de trabalho de tarefas completo, que inclui a criação de tarefas, a criação e o gerenciamento de envios de estudantes e a transmissã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 de atividades, envios de estudantes e avaliação/feedback.
Noções básicas sobre o ciclo de vida da atividade
Antes de passar para as diferenças entre o botão de compartilhamento e a API CourseWork, vamos definir o que consideramos ser 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 integrar as atividades do Google Sala de Aula:
- A atividade foi criada.
- A atividade é compartilhada com os estudantes.
- O estudante conclui a atividade.
- O estudante envia a atividade ao professor.
- O professor revisa e avalia as atividades.
A integração com as atividades do Google Sala de Aula permite que professores e estudantes trabalhem entre o app e aplicativos de terceiros sem problemas. Em vez de gerenciar os detalhes de uma atividade ou envios de estudantes, os usuários podem usar seu app para fazer isso.
Implementação
A primeira área de 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, porque só é necessário incluir o recurso JavaScript necessário e adicionar uma tag do botão de compartilhamento. Na forma mais simples, a integração do botão de compartilhamento do Google Sala de Aula pode ser semelhante ao 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 Google Sala de Aula, que exige a configuração e a ativação de chaves de API com o console do Google Cloud e a observação das práticas recomendadas para integração com uma API. Isso não é um problema se a plataforma já estiver usando outras funcionalidades da API Classroom, como horários.
Criar e compartilhar atividades
Embora o botão de compartilhamento e a API CourseWork ativem as duas primeiras etapas do fluxo de trabalho da atividade, criando e compartilhando a atividade com os estudantes, há algumas diferenças cruciais que você precisa considerar antes de escolher uma solução.
Em essência, as duas soluções permitem postar links ou arquivos como atividades no Google Sala de Aula. Isso serve como um fluxo de trabalho poderoso para professores que seriam obrigados a copiar e colar entre o Google Sala de Aula e o aplicativo de terceiros. Embora as duas soluções ofereçam a possibilidade de postar conteúdo como uma atividade, considere se o seu aplicativo precisa da flexibilidade de postar esse conteúdo como outros tipos de atividades ou até mesmo um aviso.
Ambas as opções mostram todos os tipos de postagem do Google Sala de Aula, exceto as atividades de teste. Confira abaixo um resumo de todos os tipos de postagens e se elas estã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 |
Funcionalidades como especificar título e descrição também podem ser especificadas programaticamente pelo seu 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 vencimento, 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. A API, por outro lado, expõe todos esses campos para acesso de leitura e gravação.
Modificar atividades
Eliminar a necessidade de sincronização manual dos usuários para alterar os detalhes das atividades é um dos benefícios da integração com a API Classroom. O botão de compartilhamento não tem a funcionalidade de atualizar ou excluir atividades de forma programática. Portanto, qualquer modificação necessária precisa ser feita pelo usuário, na interface do Google Sala de Aula.
A API CourseWork permite modificar e excluir atividades criadas pelo seu app, além de extrair detalhes de qualquer atividade postada nos cursos do usuário. No entanto, é importante observar que os itens do CourseWork não criados pelo mesmo console de 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, não é possível acessar o gerenciamento de envios e notas dos estudantes para esses itens do CourseWork.
Sincronizar atividades automaticamente
Com as notificações push do Pub/Sub, o aplicativo pode se inscrever em notificações que acionam um evento quando há mudanças nos itens do CourseWork e nos envios de estudantes associados. Isso permite que seu aplicativo sincronize as atividades com facilidade, eliminando a necessidade de verificações contínuas para saber 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 quem a atividade foi atribuída. Em outras palavras, para cada
atividade, há uma entrega associada a cada estudante, que
pode ser acessada com um ID exclusivo. Esses envios são criados automaticamente
e podem ser recuperados pelo seu app com os endpoints GET e LIST de envios de estudantes.
O botão de compartilhamento e a API CourseWork oferecem suporte à adição de links ou arquivos ao envio de um estudante para uma atividade. O botão de compartilhamento permite isso por meio de um fluxo de trabalho semelhante à caixa de diálogo de criação de atividades do professor e da 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 app. Essa mesma restrição não se aplica ao botão de compartilhamento. Os estudantes podem adicionar o trabalho a qualquer atividade selecionada no Google Sala de Aula.
Como encerrar o fluxo de trabalho do estudante
Embora a restrição de permissão do CourseWork não atenda a um caso de uso para plataformas que não oferecem suporte à criação de atividades, um benefício é que plataformas de terceiros podem impedir que os estudantes enviem a atividade incorreta e se esqueçam de enviar o trabalho, já que apenas o botão de compartilhamento é limitado para que os estudantes enviem as atividades.
Como revisar e avaliar atividades
A última parte do ciclo de vida da atividade volta para o professor. Depois que os estudantes entregam a atividade, o professor pode revisá-la da maneira que fizer mais sentido. No caso de arquivos armazenados no Drive, eles podem ser revisados diretamente na ferramenta de avaliação do Google Sala de Aula. No entanto, os aplicativos de terceiros não podem ser acessados no Google Sala de Aula. A implicação dessa experiência é que os professores precisam navegar por várias guias enquanto revisam e avaliam as atividades.
No momento, o botão de compartilhamento não oferece uma solução para avaliação e devolução de atividades. Embora recursos como comentários de envio dos estudantes não sejam expostos pela API, é possível atribuir notas e retornar essas notas aos estudantes através dos endpoints studentSubmissions.patch e studentSubmissions.return. As notas só podem ser especificadas para itens do fluxo do CourseWork (tipos de atividade e pergunta). Elas só estão disponíveis em formato numérico e podem ser atribuídas como rascunho ou nota 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 |
|
|
| Como concluir e enviar atividades |
|
|
| Como revisar e avaliar atividades | Não é possível especificar ou retornar notas |
|