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 tipocourseWork
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
ouannouncements.GetAddOnContextRequest
com base noitemType
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. OsubmissionIds
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.