Integração com o CourseWork

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

**Ponto principal** :uma integração CourseWork permite que os desenvolvedores acessem e modifiquem programaticamente o estado dos avisos, materiais do curso, atividades e envios dos estudantes do Google Sala de Aula. Escolha esse caminho se precisar de uma maneira econômica de enviar seu conteúdo para o Google Sala de Aula.

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

Como funciona

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

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

1. Um professor faz login no seu site.
2. O professor encontra ou cria conteúdo que quer 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 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 atividade.
   • A descrição do texto 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. Consulte a Figura 1 para ver um exemplo.
5. Uma nova coluna para a atividade também aparece no boletim de notas do Google Sala de Aula, incluindo a pontuação máxima, se fornecida.
6. Os estudantes recebem a atividade e clicam no link Material para abrir o URL fornecido em uma nova guia e visualizar ou concluir o conteúdo no seu site. Opcionalmente, forneça controles para que o estudante entregue a atividade.
7. Opcionalmente, emita uma solicitação para courses.courseWork.studentSubmissions.modifyAttachments para adicionar anexos a um envio do estudante, como um arquivo do Google Drive ou link Material que aponta para o trabalho do estudante no seu site.
8. Opcionalmente, emita 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, você pode 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 descrições detalhadas das ações relevantes da API Google Classroom.

Considerações

Ponto principal: há algumas limitações importantes para uma integração CourseWork. Se elas impedirem que você realize seu produto, crie um complemento do Google Sala de Aula em vez disso.

Tenha em mente o seguinte antes de decidir se uma integração 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. Só é possível criar atividades em cursos que o usuário autorizado ensina.
• Você precisa de uma maneira para o usuário selecionar um curso para receber o conteúdo. Considere usar courses.list para receber uma lista dos cursos ministrados pelo usuário e permitir que ele selecione um ou mais cursos na 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.
• Um professor pode modificar ou excluir a atividade de forma independente do desenvolvedor. Isso significa que o conhecimento de um desenvolvedor sobre a atividade pode ficar desatualizado. Se você precisar estar ciente das mudanças nas atividades, considere configurar notificações push para mudanças nas atividades.
• Um professor pode criar atividades na interface do Google Sala de Aula com links colados para URLs no seu site. As atividades criadas dessa maneira são de propriedade exclusiva do professor. Portanto, não é possível visualizar, modificar ou definir notas de envio usando a API Google Classroom.