A Interoperabilidade de ferramentas de aprendizagem (LTI, na sigla em inglês) é um framework aberto para criar integrações de terceiros em sistemas de gestão de aprendizagem. Embora os complementos do Google Sala de Aula e as ferramentas LTI ofereçam jornadas de usuário semelhantes, os dois frameworks não são diretamente compatíveis. Este guia compara os dois tipos de integração e destaca as principais diferenças. Ele também sugere maneiras de alcançar jornadas de usuário semelhantes ao adaptar uma ferramenta LTI para funcionar como um complemento do Google Sala de Aula.
Interações entre a plataforma e as ferramentas
Uma distinção importante entre as ferramentas LTI e os complementos do Google Sala de Aula é a maneira como as informações são trocadas. As ferramentas LTI normalmente usam HTTP POST para
transmitir payloads a uma plataforma LTI, enquanto os complementos do Google Sala de Aula
criam e recuperam recursos usando a API REST do Google Sala de Aula.
A tabela a seguir resume como alcançar os principais comportamentos da ferramenta LTI com o Google Sala de Aula.
| Recurso | LTI | Google Sala de Aula |
|---|---|---|
| Criar atividades | Serviços de atividades e notas | Criar CourseWork e AddOnAttachment recursos |
| Postar notas | Serviços de atividades e notas | Corrigir os envios de estudantes CourseWork e AddOnAttachment |
| Rotas de lançamento | Vinculação direta | Especificar URIs em AddOnAttachment recursos |
| Ler listas de cursos | Serviços de provisionamento de nomes e papéis | Recuperar Student e Teacher perfis em um curso |
Adaptar uma ferramenta LTI ao complemento do Google Sala de Aula
Muitas interações LTI têm análogos no framework de complementos do Google Sala de Aula. As seções a seguir discutem alguns conceitos importantes e cursos de ação recomendados.
Configurar seu aplicativo
Todas as interações programáticas com o Google Sala de Aula exigem um projeto do Google Cloud. Você vai configurar a listagem de aplicativos no mesmo projeto do Cloud, que define como o complemento do Google Sala de Aula vai aparecer para os usuários finais. Você vai fornecer ícones, definir o nome e a descrição do app e configurar as permissões de escopo do OAuth que seu produto exige.
A instalação do aplicativo de complemento na listagem geralmente é a única etapa de configuração que os usuários finais precisam realizar. Isso é análogo a ativar e implantar uma ferramenta LTI. Os usuários finais não precisam concluir nenhuma ação de registro ou gerenciar detalhes de configuração, embora um administrador possa precisar permitir o app no Marketplace e configurar permissões de acesso aos dados de terceiros.
Recomendação: siga nosso guia para criar e configurar um projeto do Google Cloud para um complemento do Google Sala de Aula. O mais importante é especificar um URL para o lançamento do complemento como o URI de descoberta de anexo no SDK do Marketplace. Esse URL pode ser o mesmo de uma rota de lançamento de ferramenta LTI existente, desde que ele direcione o usuário para o fluxo de autenticação apropriado.
Fluxo de autenticação
A LTI usa um fluxo de duas etapas em que um aplicativo cliente e um servidor de autenticação trocam um JWT assinado. Os usuários não precisam conceder acesso a uma ferramenta aos dados deles, já que o consentimento é implícito quando um administrador configura a ferramenta.
Em contraste, o fluxo do OAuth do Google é um fluxo de três etapas, envolvendo o usuário final, o aplicativo cliente externo e o servidor de autenticação. O cliente recebe tokens com o consentimento explícito do usuário que concedem acesso aos recursos do Google Sala de Aula do usuário.
É possível que um aplicativo de complemento alcance um comportamento semelhante de JWT assinado de duas etapas usando contas de serviço. Essas são contas que pertencem a um aplicativo em vez de um usuário individual e podem agir sem o consentimento do usuário. O uso de contas de serviço exige configuração e gerenciamento do administrador. O uso de contas de serviço com delegação em todo o domínio é fortemente desencorajado, já que elas são vetores de abuso em potencial. Consulte nosso guia para delegação em todo o domínio com integrações do Google Sala de Aula para mais detalhes.
Recomendação: quando um URL associado à sua ferramenta ou complemento recebe uma solicitação de entrada, inspecione a solicitação para verificar a presença de parâmetros de consulta do complemento do Google Sala de Aula. Se estiverem presentes, use o SDK do Google Identity para receber credenciais de acesso do usuário. Armazene as credenciais na sessão do usuário e use-as para fazer solicitações subsequentes da API Google Sala de Aula. Se os parâmetros de consulta não estiverem presentes, use solicitações HTTP para interagir com os endpoints LTI da plataforma.
Criar conteúdo de complemento no Google Sala de Aula
Os complementos do Google Sala de Aula oferecem suporte a um tipo de conteúdo: links de URL para páginas hospedadas externamente. Esses links estão contidos em AddOnAttachment recursos,
que definem as rotas da Web a serem abertas quando um usuário interage com seu
complemento. Cada URL é aberto em cenários específicos. Consulte nossos
guias de iframes para mais detalhes. Esses URLs são análogos aos links de recursos LTI.
Os complementos do Google Sala de Aula não oferecem suporte a outros tipos de conteúdo, como arquivos, imagens ou fragmentos HTML.
Recomendação: quando um usuário seleciona conteúdo no seu produto, receba as credenciais do
OAuth e faça uma solicitação AddOnAttachments.create. A solicitação precisa conter um objeto AddOnAttachment com os URLs de uma visualização do estudante, uma visualização do professor e, opcionalmente, uma visualização de notas. Observe que há
endpoints de API separados para criar anexos em avisos,
atividades ou materiais do curso. Somente os anexos criados em atividades podem ter a visualização de notas, já que esse é o único tipo de item de fluxo do Google Sala de Aula que aceita um envio de estudante.
Comparação de recursos do framework
Posicionamentos de integração
Os complementos do Google Sala de Aula criam anexos em avisos, atividades e materiais do curso. Esses são os itens que aparecem na guia "Fluxo" de um curso na interface do Google Sala de Aula.
Os professores iniciam a jornada de criação de anexos de complementos selecionando um complemento em um seletor no fluxo de criação de atividades. Consulte os guias de iframes para uma discussão detalhada de cada visualização apresentada aos usuários.
Como alternativa, os desenvolvedores podem criar atividades de forma programática com anexos de complementos. Consulte nosso guia para criar anexos fora do Google Sala de Aula para mais detalhes.
Informações de contexto de lançamento
O Google Sala de Aula anexa vários parâmetros de consulta a cada URL ao abrir uma rota de complemento. Eles sempre incluem o tipo de item de fluxo e identificadores para o curso e o item de fluxo. Outras informações podem estar presentes dependendo da visualização do iframe, como os identificadores de anexo ou envio, um token para autorizar a criação de anexos ou o URL para fazer upgrade de um link para um anexo de complemento.
O Google Sala de Aula não transmite nenhuma informação sobre o usuário ou a instituição por padrão. É possível receber informações sobre o usuário no recurso UserProfile da API Google Sala de Aula, incluindo um ID de usuário. Se o usuário for um administrador de domínio, você poderá receber informações sobre a instituição no SDK Admin do Workspace.
Autenticação e autorização
Os complementos do Google Sala de Aula precisam usar Fazer login com o Google para autenticação do usuário. Depois de fazer login, os usuários concedem permissão ao aplicativo usando escopos do OAuth 2.0. O aplicativo pode usar qualquer combinação de escopos do OAuth disponíveis.
Descoberta e configuração de apps
Os usuários encontram e "instalam" complementos do Google Sala de Aula pelo Google Workspace Marketplace. A instalação com um clique disponibiliza um aplicativo de complemento para um professor individual. Opcionalmente, um administrador pode instalar o aplicativo de complemento para todos os professores em uma unidade organizacional ou domínio. Os anexos feitos com o aplicativo ficam acessíveis a todos os estudantes de um curso. Não é necessário que os usuários finais gerenciem tokens, chaves ou identificadores para complementos individuais do Google Sala de Aula.
Fluxo de UX e produto
Em muitos casos, o fluxo de produtos de uma ferramenta LTI funciona bem como um complemento do Google Sala de Aula. Semelhante a uma ferramenta LTI, um complemento do Google Sala de Aula permite criar e gerenciar links para seu conteúdo na nossa plataforma. Os anexos de complementos do Google Sala de Aula são semelhantes aos links de vinculação direta LTI. Se a ferramenta LTI criar URLs que apontam para o conteúdo hospedado, ela vai funcionar bem como um complemento do Google Sala de Aula.
Dar nota ao trabalho dos estudantes
Os anexos de complementos do Google Sala de Aula podem ser visualizados e classificados na visualização do classificador do Google Sala de Aula. Ao anexar conteúdo que exige um envio do estudante, você fornece um student_work_review_uri em que um professor pode visualizar e classificar o trabalho de um estudante específico. Isso é diferente da LTI, em que uma ferramenta define apenas um target_link_uri comum a professores e estudantes. A implementação de complementos do Google Sala de Aula é
mais semelhante ao futuro serviço de revisão de envio LTI.