Estratégia de implementação

Esta página oferece uma breve visão geral das principais interações entre seu aplicativo da Web complementar 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 professores no seu complemento. Considere as seguintes ações em relação a essa visualização:

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

    Opcionalmente, determine se o item de transmissão vai aceitar respostas dos estudantes, para impedir que o professor adicione anexos do tipo atividade. Confira o valor do parâmetro de consulta itemType que foi transmitido quando o iframe do complemento foi aberto. Somente o tipo courseWork aceita respostas dos estudantes.

  • Com base nas seleções do professor, faça uma ou mais solicitações de complemento create para adicionar anexos à atividade.

Outros iframes

O iframe da visão do estudante, o iframe da revisão do trabalho do estudante e o iframe da visão do professor têm como objetivo apresentar conteúdo ao usuário em vez de modificar uma atividade do Google Sala de Aula. Considere realizar as seguintes ações em relação a essas visualizações:

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