O iframe de descoberta de anexos é a visualização inicial mostrada a um professor ao abrir um complemento durante a criação de uma atividade 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 complementos que um professor pode anexar.
Depois que um professor seleciona um complemento, o Classroom cria um iframe de descoberta de anexos e carrega o URL de inicialização do complemento. Todos os parâmetros de consulta de iframe relevantes são transmitidos ao URL de inicialização (Figura 2).
Figura 2. Exemplo de uma interface de descoberta de anexos em um iframe.
A visualização "Descoberta de anexos" é como a página de destino dos professores no seu complemento. Normalmente, o professor usa o aplicativo da Web do parceiro no iframe para selecionar o conteúdo que será anexado ao item do stream. O aplicativo complementar pode restringir o conteúdo mostrado dependendo se o item do stream é um aviso, uma atividade ou um material do curso. Em seguida, o aplicativo complementar faz chamadas da API Classroom para criar e anexar o arquivo à atividade.
Quando o professor terminar de selecionar e criar anexos, o
complemento vai enviar uma carga útil postMessage solicitando o
fechamento do iframe. O iframe é fechado, e o professor vê os anexos, que podem ser visualizados ou removidos da atividade (Figura 3). O professor conclui o fluxo de criação atribuindo o item do
fluxo aos estudantes.
Figura 3. Visualização da criação de uma atividade com três anexos de complemento de tipo de atividade.
Considerações sobre a experiência do usuário
- Na abertura inicial, o complemento precisa pedir que o professor faça login.
- O SSO do Google é necessário para todas as chamadas da API Classroom. Se o produto tiver um sistema de login separado, você precisará vincular as contas.
- Um professor precisa conseguir visualizar um anexo no iframe antes de fazer a seleção final.
- Um 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 filtro por habilidades de aprendizado.
- O complemento precisa oferecer a capacidade de criar um novo item anexável no iframe.
Consulte a lista 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 seu produto, uma mensagem clara deve ser mostrada para explicar como um professor sem licença pode resolver a situação. Considere também ocultar ou desativar conteúdo que não esteja disponível para um professor devido a restrições de licenciamento.