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 do 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, um professor cria uma nova postagem (por exemplo, uma atividade, aviso ou pergunta) e seleciona um complemento na lista suspensa de complementos. Por um curto período (de horas), o Google Sala de Aula permite que o complemento adicione anexos à postagem.
Figura 1. Visualização de uma
criação de atividade, incluindo as possíveis opções de complementos que um professor pode anexar.
Depois que um professor seleciona um complemento, o Google Sala de Aula cria um iframe de descoberta de anexos e carrega o URL de início do complemento. 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 app 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á ver os anexos que podem ser visualizados ou removidos da atividade.
Figura 3. Visualização de uma criação de atividade com três anexos de complementos do tipo de atividade.
Considerações sobre a UX no iframe
- Na primeira abertura, o complemento precisa solicitar que o professor faça login.
- O Logon único do Google é obrigató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.
- O professor precisa conseguir pesquisar ou navegar pelo conteúdo que pode ser anexado.
- O complemento pode oferecer várias visualizações, como conteúdo recente, meu conteúdo e filtrar por habilidades de aprendizado.
- O complemento precisa oferecer a possibilidade de criar um novo item anexável a partir do iframe.
Consulte a lista de verificação de requisitos dos complementos 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 sobre 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:
- Mostra 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 um professor devido a restrições no nível de licenciamento.