Estratégia de implementação

Esta página fornece uma breve visão geral das principais interações entre seu aplicativo da Web de complementos e a API de complementos do Google Sala de Aula.

iframe de descoberta de anexos

O iframe de descoberta de anexos é a página de destino para os professores no seu complemento. Considere o seguinte em relação a essa vista:

  • Mostre a interface de descoberta ou criação de conteúdo.

    Também é possível determinar se o item de fluxo aceitará as respostas dos alunos, já que é possível impedir que o professor adicione anexos de tipo de atividade. Verifique o valor do parâmetro de consulta itemType que foi transmitido quando o complemento foi aberto com iframe. Somente o tipo courseWork aceita respostas de estudantes.

  • Com base nas seleções dos professores, faça uma ou mais solicitações de complementos create para adicionar anexos à atividade.

Outros iframes

O iframe da visualização dos alunos, o iframe da avaliação dos trabalhos dos alunos e o iframe da visualização dos professores servem para apresentar conteúdo ao usuário em vez de modificar uma atividade no Google Sala de Aula. Considere tomar as seguintes medidas em relação a essas visualizações:

  • Quando um iframe for aberto, solicite o consentimento do OAuth do usuário e valide a função e o ID do anexo.
  • Quando um iframe abrir, crie um courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest ou announcements.GetAddOnContextRequest com base no itemType para validar o papel do usuário.
  • Se o usuário atual for um estudante, associe o submissionId da resposta ao trabalho do estudante. Isso é necessário para retornar notas e para mostrar o trabalho do estudante aos professores na ferramenta de notas. O submissionIds corresponde em todas as visualizações.
  • Se o attachmentId já for conhecido pelo complemento, mostre a interface do anexo adequada.
  • Caso contrário, a postagem pai deste anexo foi copiada de outra postagem ou curso. Use copyHistory para identificar a cópia mais recente de que o complemento está ciente e copie as configurações dele para criar um novo modelo correspondente do anexo no complemento. Em seguida, mostre a interface do anexo adequada.