Integração com o CourseWork

Os desenvolvedores podem usar a API Google Sala de Aula para interagir com os trabalhos no Google Sala de Aula. Um aplicativo que usa a API dessa maneira é chamado de integração CourseWork.

Esse caminho de integração é usado geralmente para criar e avaliar atividades com links para recursos fora do Google Sala de Aula. Ele oferece mais acesso de desenvolvedor ao gerenciamento de atividades do curso em comparação com os botões de compartilhamento do Google Sala de Aula.

Como funciona

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

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

1. Um usuário professor faz login no seu site.
2. O professor encontra ou cria o conteúdo que quer compartilhar com a turma. O professor clica em um botão no seu site para enviar o conteúdo ao Google Sala de Aula.
3. Seu aplicativo emite uma solicitação para courses.courseWork.create. A solicitação contém um objeto CourseWork no corpo que contém:
   • O ID do curso de destino.
   • O título da tarefa.
   • A descrição de texto da atividade.
   • Um link Material com o URL do conteúdo selecionado pelo professor.
   • Opcionalmente, a pontuação máxima alcançá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 a Figura 1 para conferir um exemplo.
5. Uma nova coluna para a atividade também aparece na plataforma de notas 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 conferir ou concluir o conteúdo no seu site. Opcionalmente, forneça controles para o estudante entregar a atividade.
7. Outra opção é enviar uma solicitação ao courses.courseWork.studentSubmissions.modifyAttachments para 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. Também é possível enviar uma solicitação para courses.courseWork.studentSubmissions.patch para definir a nota do estudante para a atividade.

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

Como alternativa, chame courses.announcements.create ou courses.courseWorkMaterials.create para criar um aviso ou material de 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 a integração com CourseWork é a escolha certa para as necessidades do seu produto.

• Você precisa autorizar o usuário e solicitar o consentimento dele. Você está fazendo solicitações de API em nome do usuário. Isso significa, por exemplo, que não é possível criar atividades em qualquer curso do Google Sala de Aula. Você só pode criar atividades em cursos que o usuário autorizado ministra.
• Você precisa de uma maneira para o usuário selecionar um curso e receber o conteúdo. Use courses.list para receber 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 no Google Sala de Aula, o link é aberto em uma nova guia. Seu servidor não vai receber nenhuma informação do Google Sala de Aula quando o URL for aberto.
• Os professores podem modificar ou excluir a atividade independentemente do desenvolvedor. Isso significa que o conhecimento de um desenvolvedor sobre o curso pode ficar desatualizado. Se você precisar saber sobre mudanças no trabalho, configure notificações push para isso.
• Um professor pode criar um trabalho na interface do Google Sala de Aula com links colados para URLs no seu site. O trabalho acadêmico criado dessa maneira é de propriedade exclusiva do professor. Portanto, não será possível visualizar, modificar ou definir notas de envio usando a API Classroom.