Escolher um caminho de integração

Este guia apresenta as opções para conectar seu serviço ou aplicativo ao Google Sala de Aula. Selecione um desses caminhos para disponibilizar seu conteúdo aos usuários nos itens de transmissão do Google Sala de Aula.

Opções de integração

Há três maneiras de conectar seus materiais de aprendizagem ao Google Sala de Aula:

  1. Incorporar botões de Compartilhar do Google Sala de Aula no seu produto
  2. Use a API CourseWork para criar e gerenciar itens de transmissão com hiperlinks para seu produto
  3. Crie um complemento do Google Sala de Aula para que os usuários possam descobrir e acessar seu conteúdo no Google Sala de Aula.

Os botões de compartilhamento do Google Sala de Aula são a integração menos complexa. Você incorpora um script ao seu aplicativo da Web. O script gera um botão, em que os usuários clicam para criar itens do feed do Google Sala de Aula. No entanto, o aplicativo não pode acessar esses itens de fluxo após a criação nem acessar outros dados do Google Sala de Aula.

Os caminhos de complemento da API CourseWork e do Google Sala de Aula exigem que seu aplicativo da Web use solicitações da API Classroom para controlar diretamente os itens de transmissão e o conteúdo deles. O app mantém o acesso a itens de streaming ou outros recursos criados por qualquer um dos caminhos. Você também pode solicitar permissão do usuário para acessar outros dados do Google Sala de Aula. No entanto, você é responsável por hospedar, testar e manter todo o código que interage com o Google.

Os complementos do Google Sala de Aula oferecem a melhor experiência do usuário e oportunidades de descoberta para seu produto.

Quais jornadas do usuário são aceitas?

Cada caminho de integração oferece uma experiência do usuário e acesso aos recursos do Google Sala de Aula diferentes. Consulte a matriz de jornadas do usuário a seguir para comparar os três caminhos.

Os ícones na tabela a seguir indicam se a jornada do usuário tem suporte total, não tem suporte ou tem suporte com ressalvas. Clique em qualquer para conferir informações mais detalhadas.

Jornada Botões de compartilhamento do Google Sala de Aula API CourseWork Complemento do Sala de Aula
Os usuários dão consentimento do OAuth para meu app
Posso acessar os recursos do Google Sala de Aula associados a um usuário, como listas de estudantes e cursos
Posso criar trabalhos que vinculam ao meu conteúdo
Posso modificar os trabalhos que criei
Posso modificar os trabalhos que os usuários criam
Posso definir notas para os envios dos estudantes
Só é possível definir notas para trabalhos que você cria de forma programática. Não é possível definir notas em atividades criadas por professores na interface do Google Sala de Aula.
Continuar
Posso acessar os anexos nos envios dos estudantes
Só é possível acessar anexos de trabalhos que você criou programaticamente. Não é possível acessar anexos de atividades criadas por professores.
Continuar
Os professores encontram meu conteúdo na interface do Google Sala de Aula

Quais são as diferenças na experiência do desenvolvedor?

Cada caminho de integração oferece uma experiência diferente para os desenvolvedores. Consulte a matriz de expectativas dos desenvolvedores abaixo para comparar os três caminhos.

Os ícones na tabela a seguir indicam o quanto as opções de integração correspondem a cada jornada do desenvolvedor. Clique em qualquer para ver informações clarificadoras.

Jornada Botões de compartilhamento do Google Sala de Aula API CourseWork Complemento do Sala de Aula
Posso criar uma integração sem comprar produtos do Google
Posso personalizar a aparência do meu conteúdo no Google Sala de Aula
É possível definir campos de atribuição diretamente. Os rastreadores da Web do Google vão recuperar ícones e títulos para os links de URL especificados.
Continuar
Recebo informações sobre o usuário ou o curso quando ele abre meu conteúdo no Google Sala de Aula
Você pode codificar detalhes de identificação nos links de URL criados no Google Sala de Aula. No entanto, eles são frágeis e propensos a quebras, já que os usuários copiam o conteúdo de um curso para outro.
Continuar