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
ouannouncements.GetAddOnContextRequest
com base noitemType
para validar o papel do usuário e receber o valorsupportsStudentWork
. - 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. OsubmissionIds
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.
- Se o usuário atual for um estudante, associe o