Estratégia de implementação

Nesta página, você encontra uma 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 do Discovery de anexos

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

  • Quando o iframe de descoberta de anexos for aberto, crie um courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest ou announcements.GetAddOnContextRequest com base no itemType para validar o papel do usuário e receber o valor supportsStudentWork.
  • mostrar a interface de descoberta ou criação de conteúdo; É possível omitir anexos do tipo de atividade com base no valor de supportsStudentWork da resposta de validação de inicialização.
  • Com base nas seleções dos professores, faça uma ou mais solicitações create de complementos para adicionar anexos à atividade.

Outros iframes

O iframe de visualização dos estudantes, o iframe de avaliação dos trabalhos dos estudantes e o iframe da visualizaçã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 com relação a essas visualizações:

  • Quando um iframe for aberto, solicite o consentimento do OAuth do usuário e valide o papel e o ID do anexo.

    • Se o usuário atual for um estudante, associe o submissionId da resposta ao trabalho dele. Isso é necessário para transmitir notas e para mostrar os trabalhos dos estudantes aos professores na ferramenta de notas. O submissionIds corresponde às visualizações.
    • Se o attachmentId já for conhecido pelo complemento, mostre a interface de anexo adequada.
    • Caso contrário, talvez a postagem mãe desse anexo tenha sido 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 dela para criar um novo modelo correspondente do anexo no lado do complemento. Em seguida, mostre a interface de anexo adequada.