Introdução à integração do Google Workspace para administradores

O Google Workspace pode ser integrado ao Learn. Quando o Google Workspace está habilitado em sua instituição, os instrutores podem acessar arquivos de seus Google Drives e vincular os arquivos aos cursos Ultra. Os arquivos incluem documentos, slides e planilhas criados no Google Drive.

Os instrutores podem vincular os arquivos do Google Workspace à área de conteúdo do curso, aos módulos de aprendizagem e às pastas. Qualquer alteração que os instrutores fizerem no arquivo do Google Workspace será aplicada a cada link que o instrutor tiver adicionado.

Somente arquivos da pasta Meu Drive do instrutor podem ser vinculados a um curso por meio do Google Workspace.

Para integrar o Google Workspace, você precisa

  1. Registrar o Google Workspace no Learn
  2. Configurar o Google Workspace no Google Cloud
  3. Ativar a integração do Google Workspace no Learn

A segunda etapa exigirá que você acesse a documentação oficial do Google.

Configurar o Google Workspace no Google Cloud

O Learn é compatível com vários domínios configurados em um domínio principal registrado no Google Cloud. Se sua instituição gerenciar vários domínios (por exemplo, um para instrutores e outro para alunos), você poderá adicionar um domínio de alias de usuário ou um domínio secundário no Google Cloud. Siga as etapas na Ajuda do administrador do Google Workspace.

Você precisa definir as configurações da sua instituição no Google Cloud, também conhecido como sua conta do desenvolvedor do Google. O Google Cloud está fora do Learn e precisa ser acessado usando suas credenciais do Google. Siga as etapas descritas abaixo. 

Você pode visualizar um exemplo dessas etapas em PDF. Informações detalhadas aparecem na documentação do Google vinculada em cada etapa abaixo.

1. Configure um projeto novo. Acesse o site de ajuda do Google para saber como configurar um novo projeto para a sua instituição.

2. Configure uma tela de consentimento. Acesse o site de ajuda do Google para saber como configurar uma tela de consentimento para sua instituição. Para concluir a configuração da tela de consentimento, você precisará adicionar o escopo inserindo manualmente o URL https://www.googleapis.com/auth/drive em sua conta de desenvolvedor do Google.

3. Configuração do cliente Google. Acesse o site de ajuda do Google para saber como definir a Configuração do cliente no Google. Use esta tabela para identificar o URI de redirecionamento. Você precisa deste URI para concluir esta etapa. 

Tabela de códigos do cliente para diferentes regiões
Código do clienteRegiãoURI de redirecionamento
57dfd374-a957-4352-a6f8-9cf398a554ebus-east-1us.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
136cad97-f53f-4719-a320-be308424864beu-central-1eu.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
4f3043a9-2687-4f2b-8014-7d662142f3ebca-central-1ca.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
43dcf283-7e70-4594-9caa-30a16ce2b605ap-southeast-2au.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0dap-southeast-1sg.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
b863c2bb-2b80-45d1-af82-1a3e152eaaa8ap-northeast-2kr.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
5cf09ba6-60be-4b5b-aaf9-61f7f3c0be9caf-south-1sa.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

As informações a seguir devem ser criadas no Google Cloud para concluir a integração da sua instituição com o Google:

  • Código do cliente
  • Chave API
  • Segredo do cliente
  • Nome da conta de serviço
  • Arquivo de credencial de conta de serviço
  • Código do Drive compartilhado

Visite o site de ajuda do Google Workspace para saber como obter todas as informações necessárias.

Você pode obter o código do Drive compartilhado copiando o código da pasta para o Workspace da sua instituição. Você pode encontrar o código da pasta copiando o que aparece no campo URL seu navegador ao acessar a pasta. Copie tudo o que aparece depois de drive.google.com/drive/u/1/folders/

Image of the UI for Google Workspace with the folder URL in the URL field of the browser

4. Ative as APIs na biblioteca do APP. Acesse o site de ajuda do Google para ativar as APIs do Google. Você deve selecionar as seguintes APIs:

  1. API Google Drive
  2. API Google Picker

Registrar o Google Workspace no Learn

1. No Painel do administrador da sua instituição no Learn, selecione Provedores da ferramenta de LTI na categoria Integrações.

2. Selecione Registrar a ferramenta de LTI 1.3.

3. No campo código do cliente, digite ou copie e cole o código do cliente da sua região.

Tabela de códigos do cliente para diferentes regiões
RegiãoCódigo do cliente
us-east-157dfd374-a957-4352-a6f8-9cf398a554eb
eu-central-1136cad97-f53f-4719-a320-be308424864b
ca-central-14f3043a9-2687-4f2b-8014-7d662142f3eb
ap-southeast-243dcf283-7e70-4594-9caa-30a16ce2b605
ap-southeast-1c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0d
ap-northeast-2b863c2bb-2b80-45d1-af82-1a3e152eaaa8
af-south-15cf09ba6-60be-4b5b-aaf9-61f7f3c0be9c

4. Selecione Enviar

5. Analise todas as configurações preenchidas automaticamente na visualização de Status da ferramenta. Certifique-se de que o botão Status da ferramenta esteja definido como Aprovado.

6. Em Políticas da instituição, todas as configurações ficam ativas por padrão. Recomendamos deixar todas as configurações ativas, caso sua instituição decida usar mais configurações posteriormente.

7. Selecione Enviar para concluir o registro da LTI 1.3. A integração do Google agora é exibida como uma opção no Painel do administrador, na categoria Ferramentas e utilitários.

Adicionar o código do cliente configura as diferentes colocações de integração do Google no Learn por padrão.

  • Links Google LTI no resumo do conteúdo
  • Configurações do administrador
  • Links Google LTI no Content Market

Ativar a integração do Google Workspace no Learn

1. Selecione a página Integração do Google em Ferramentas e utilitários no Painel do administrador no Learn.

Image of the Administrator Panel in Learn, with the link for Google Integration highlighted at the bottom

2. Preencha todos os campos obrigatórios com as informações que você recebeu do Google Cloud ao configurar o Workspace. Se sua instituição tiver dois Google Workspaces, selecione Conectar outro Google Workspace para inserir as informações do segundo Google Workspace. 

Todos os alunos precisam ter a função na instituição de Aluno para poder acessar o conteúdo do Google adicionado ao curso pelo instrutor. 

Google Integration page, showing the required fields for completing integration, with the Connect another Google Workspace button highlighted

3. Selecione Enviar para ativar a integração do Google Workspace em sua instituição.