O iframe de descoberta de anexos é a visualização inicial mostrada para um professor ao abrir um complemento durante a criação de uma tarefa no Google Sala de Aula. Um anexo é o conteúdo ou a atividade com que você quer que os alunos interajam.
Em um curso do Google Sala de Aula, o professor cria uma nova postagem (por exemplo, uma atividade, aviso ou pergunta) e seleciona um complemento na lista suspensa. Por um curto período de tempo (em algumas horas), o Google Sala de Aula permite que o complemento adicione anexos à postagem.
Figura 1. Visualização da criação de uma atividade, incluindo as possíveis opções de complementos que um professor pode anexar.
Depois que o professor seleciona um complemento, o Google Sala de Aula cria um iframe de descoberta de anexos e carrega o URL de início dele. Todos os parâmetros de consulta de iframe relevantes são transmitidos para o URL de início.
Figura 2. Exemplo de uma interface de descoberta de anexos em um iframe.
O professor usa o aplicativo da Web do parceiro, em um iframe, para selecionar um anexo. O aplicativo faz chamadas da API Classroom para anexar o anexo à atividade. Quando o professor termina de selecionar os anexos, o complemento envia um payload postMessage
solicitando que o iframe seja fechado.
O iframe será fechado, e o professor poderá conferir os anexos e escolher visualizar ou remover uma prévia da atividade.
Figura 3. Visualização da criação de uma atividade com três anexos de complemento do tipo de atividade.
Considerações sobre a UX no iframe
- Na primeira abertura, o complemento precisa pedir que o professor faça login.
- O Logon único do Google é necessário para todas as chamadas da API Classroom. Se o produto tiver um sistema de login separado, será necessário vincular as contas.
- O professor precisa conseguir visualizar um anexo no iframe antes de fazer a seleção final.
- Os professores precisam conseguir pesquisar ou navegar por conteúdos que podem ser anexados.
- O complemento pode oferecer uma variedade de visualizações, como conteúdo recente, meu conteúdo e filtrar por habilidades de aprendizado.
- O complemento precisa permitir a criação de um novo item anexável no iframe.
Consulte a lista de verificação de requisitos do complemento do Google Sala de Aula para mais detalhes sobre os requisitos de UX.
Mostrar o status de licenciamento no iframe
Se o complemento exigir uma licença e o professor não tiver uma, uma mensagem clara precisa ser apresentada ao professor, informando as próximas etapas para resolver a situação. Isso evita qualquer confusão que possa surgir de restrições de licenciamento.
Também recomendamos que seu complemento:
- Exibe o nível de licenciamento do professor no iframe da descoberta de anexos.
- Oculta ou desativa conteúdo que não está disponível para professores devido a restrições no nível do licenciamento.