Integração com o CourseWork

Os desenvolvedores podem usar a API Google Sala de Aula para interagir com as atividades do Google Sala de Aula. Um aplicativo que usa a API dessa forma é chamado de integração CourseWork.

Esse caminho de integração é usado com frequência para criar e corrigir atividades com links para recursos fora da Sala de Aula. Ele oferece mais acesso de desenvolvedor ao gerenciamento de atividades em comparação com os botões de compartilhamento do Sala de Aula.

Como funciona

O recurso principal de uma integração do CourseWork é a criação e o gerenciamento de atividades, avisos e materiais do curso usando a API Classroom.

Um exemplo de jornada do usuário comum ativada por uma integração do CourseWork é permitir que os professores descubram, atribuam e avaliem conteúdo no seu site ou aplicativo:

  1. Um professor faz login no seu site.
  2. O professor encontra ou cria conteúdo para compartilhar com a turma. O professor clica em um botão no seu site para enviar esse conteúdo ao Google Sala de Aula.
  3. Seu aplicativo envia uma solicitação para courses.courseWork.create. A solicitação contém um objeto CourseWork no corpo com:
    • O ID do curso de destino.
    • O título da atividade.
    • A descrição textual da atividade.
    • Um link Material com o URL do conteúdo selecionado pelo professor.
    • Opcionalmente, a pontuação máxima possível para o conteúdo selecionado.
  4. Uma nova atividade aparece no Google Sala de Aula com um anexo de link. O link se refere ao URL especificado na solicitação create. Confira um exemplo na Figura 1.
  5. Uma nova coluna para a atividade também aparece no boletim do Google Sala de Aula, incluindo a pontuação máxima, se fornecida.
  6. Os estudantes recebem a atividade e clicam em link Material para abrir o URL fornecido em uma nova guia e acessar ou concluir o conteúdo no seu site. Se quiser, ofereça controles para que o estudante entregue a atividade.
  7. Se quiser, faça uma solicitação para courses.courseWork.studentSubmissions.modifyAttachments adicionar anexos ao envio de um estudante, como um arquivo do Google Drive ou link Material que aponte para o trabalho do estudante no seu site.
  8. Se quiser, emita uma solicitação para courses.courseWork.studentSubmissions.patch definir a nota do estudante para a atividade.

Editar uma atividade do Google Sala de Aula com um material de link anexado

Figura 1. Visualização do professor ao editar uma atividade criada por uma integração do CourseWork.link Material

Outra opção é chamar courses.announcements.create ou courses.courseWorkMaterials.create para criar um aviso ou material do curso em vez de uma atividade. Consulte as páginas Criar e gerenciar atividades e Definir e atualizar notas para ver descrições detalhadas das ações relevantes da API Classroom.

Considerações

Considere o seguinte antes de decidir se uma integração do CourseWork é a escolha certa para as necessidades do seu produto.

  • Você precisa autorizar o usuário e pedir o consentimento dele. Você está fazendo solicitações de API em nome do usuário. Por exemplo, não é possível criar atividades em qualquer curso do Google Sala de Aula. Só é possível criar atividades nos cursos em que o usuário autorizado ensina.
  • Você precisa de uma maneira para o usuário selecionar um curso e receber o conteúdo. Considere usar courses.list para acessar uma lista dos cursos ministrados pelo usuário e permitir que ele selecione um ou mais cursos da lista.
  • Quando um usuário clica em um link Material na Sala de Aula, o link é aberto em uma nova guia. O servidor não vai receber nenhuma informação da Sala de Aula quando o URL for aberto.
  • Um professor pode modificar ou excluir o material didático de forma independente do desenvolvedor. Isso significa que o conhecimento de um desenvolvedor sobre o curso pode ficar desatualizado. Se você precisar ficar por dentro das mudanças nas atividades, configure notificações push para receber alertas sobre alterações.
  • Um professor pode criar atividades na interface do Google Sala de Aula com links colados para URLs no seu site. Os trabalhos criados dessa forma são de propriedade exclusiva do professor. Por isso, não é possível ver, modificar ou definir notas de envio usando a API Classroom.