O iframe de descoberta de anexos é a visualização inicial mostrada a 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 estudantes interajam.
Em um curso do Google Sala de Aula, um professor cria uma nova postagem (por exemplo, uma atividade, um aviso ou uma pergunta) e seleciona um complemento na lista suspensa de complementos (Figura 1).
Figura 1. Visualização da criação de uma atividade, incluindo as possíveis opções de complemento que um professor pode anexar.
Quando um professor seleciona um complemento, o Google Sala de Aula cria um iframe de descoberta de anexos e carrega o URL de inicialização do complemento. Todos os parâmetros de consulta do iframe relevantes são transmitidos para o URL de inicialização (Figura 2).
Figura 2. Exemplo de uma interface de descoberta de anexos em um iframe.
Pense na visualização "Descoberta de anexos" como a página de destino para professores no seu complemento. Normalmente, o professor usa o aplicativo da Web do parceiro no iframe para selecionar o conteúdo a ser anexado ao item de transmissão. O aplicativo de complemento pode restringir o conteúdo que é exibido dependendo se o item de transmissão é um aviso, uma atividade ou material do curso. O aplicativo complementar faz chamadas da API Classroom para criar e anexar o anexo à atividade.
Quando o professor termina de selecionar e criar anexos, o
complemento envia um payload postMessage solicitando que o
iframe seja fechado. O iframe é fechado, e o professor tem acesso aos
anexos, que podem ser visualizados ou removidos da
atividade (Figura 3). O professor conclui o fluxo de criação atribuindo o
item de transmissão aos estudantes.
Figura 3. Visualização de uma criação de atividade com três anexos de complemento de tipo atividade.
Considerações sobre a experiência do usuário
- Na abertura inicial, o complemento precisa solicitar que o professor faça login.
- O login único do Google é obrigatório para todas as chamadas da API do Classroom. Se o produto tiver um sistema de login separado, será necessário vincular as contas.
- Um professor precisa ter acesso à prévia de um anexo no iframe antes de fazer a seleção final.
- Um professor precisa poder 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 capacidade de criar um novo item que possa ser anexado no iframe.
Consulte a lista de verificação de requisitos do complemento do Google Sala de Aula para mais detalhes sobre os requisitos de experiência do usuário.
Status de licenciamento
Se o complemento exigir uma licença para o produto, uma mensagem clara precisa ser mostrada para explicar como um professor sem licença pode resolver a situação. Considere também ocultar ou desativar o conteúdo que não está disponível para um professor devido a restrições de licenciamento.