O iframe de descoberta de anexos é a visualização inicial mostrada para um professor quando abrir um complemento durante a criação de uma tarefa no Google Sala de Aula. Um anexo é o conteúdo ou a atividade que você quer permitir aos estudantes; interagir.
Em um curso do Google Sala de Aula, o professor cria uma nova postagem (para exemplo, uma atividade, aviso ou pergunta) e seleciona um complemento de na lista suspensa de complementos. Por um curto período de tempo (em horas), O Google Sala de Aula permite que o complemento adicione anexos à postagem.
Figura 1. Visualização de um
a criação de atividades, 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 anexo Iframe de descoberta e carrega o URL de início do complemento. Qualquer consulta de iframe relevante parâmetros são transmitidos ao 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 uma
anexo. O aplicativo faz chamadas da API Classroom para anexar o anexo
à tarefa. Quando o professor terminar de selecionar anexos, o
envia um payload postMessage solicitando que o iframe seja fechado.
O iframe será fechado, e o professor poderá ver os anexos. optar por visualizar ou remover da tarefa.
Figura 3. Visualização da criação de uma atividade com três complementos de tipo de atividade anexos.
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 seu produto tem um sistema de login separado, você deve vincular as contas.
- O professor precisa conseguir visualizar um anexo no iframe antes na seleção final.
- Os professores precisam conseguir pesquisar ou navegar pelos conteúdo.
- O complemento pode oferecer visualizações variadas, 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 usando no iframe.
Consulte a lista de verificação de requisitos do complemento do Google Sala de Aula para mais detalhes sobre 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 uma mensagem precisa ser apresentada ao professor informando sobre a próxima etapas para solucionar a situação. Isso evita qualquer confusão que possa surgir restrições de licenciamento.
Também recomendamos que seu complemento:
- Mostra o nível de licenciamento do professor na Descoberta de anexos iframe.
- Oculta ou desativa conteúdo que não está disponível para professores devido ao licenciamento restrições no nível da conta.