Como acessar, criar e modificar atividades no Google Sala de Aula
O que posso criar com os endpoints do CourseWork na API Classroom?
Os endpoints permitem que os desenvolvedores visualizem e gerenciem o trabalho em uma turma. Mais especificamente, é possível fazer o seguinte:
- Acessar atividades e perguntas (chamadas coletivamente de
CourseWork) para um usuário - Criar, modificar e excluir
CourseWork - Anexar materiais (arquivos do Drive, vídeos do YouTube, links) a
CourseWork - Mudar o estado do envio de um estudante (por exemplo, entrega, devolução, recuperação)
- Definir a nota de um envio de atividade
- Anexar materiais (arquivos do Drive, vídeos do YouTube, links) aos envios dos estudantes
Alguns exemplos de casos de uso para CourseWork:
- Os livros de notas, os sistemas de informações dos alunos (SIA) ou os sistemas de relatórios podem sincronizar atividades e notas do Google Sala de Aula com os aplicativos, eliminando a transferência manual de dados.
- Os aplicativos de aprendizagem podem criar novas atividades que aparecem no stream da turma. À medida que os estudantes concluem o trabalho, os apps podem enviar o trabalho, definir notas, anexar o trabalho do estudante e armazenar o trabalho nas pastas adequadas do Drive.
- Os usuários professores podem criar atividades com anexos de complementos no seu site ou aplicativo.
- Os usuários estudantes podem entregar as atividades que têm seus anexos de complemento.
Quais permissões meu app precisa para criar ou modificar atividades?
Normalmente, um aplicativo só pode modificar o trabalho que ele cria. Em outras palavras, todas as solicitações de API de mutação de atribuição precisam usar o mesmo ID do projeto do Google Cloud que foi armazenado no momento da criação da atribuição.
Os complementos do Google Sala de Aula têm uma exceção a essa regra. Um projeto do Google Cloud pode acessar ou modificar qualquer anúncio, atividade ou material que tenha um ou mais anexos de complementos. Um projeto da nuvem também pode entregar, recuperar ou devolver uma atividade que tenha um ou mais anexos de complementos.
As solicitações de API também exigem os escopos de usuário corretos. Os professores podem conferir
atividades, criar atividades, anexar links a envios de atividades e definir
notas. Os estudantes podem conferir as atividades, anexar links aos registros de atividades e entregar e recuperar os envios. Os administradores
do domínio podem acessar CourseWork, mas não têm permissões de gravação.
Que tipos de itens minha inscrição pode anexar a atividades ou envios?
A API oferece suporte para anexar arquivos do Drive, vídeos do YouTube e links. Ainda não é possível anexar formulários nativos do Google.
Os usuários finais sabem que uma atividade no Google Sala de Aula foi criada pelo meu app?
Sim. A interface do Classroom identifica as atividades criadas externamente usando o nome do produto do projeto do Google Cloud que criou o trabalho. Os usuários podem relatar trabalhos criados externamente como indesejados e desconectar o app que criou o trabalho, revogar todas as credenciais emitidas para o app pelo usuário.
Botão de compartilhamento do Google Sala de Aula e outras integrações
Eu já integrei o botão de compartilhamento do Google Sala de Aula. Posso modificar uma atividade criada usando o botão de compartilhamento?
Ainda não. Para modificar uma atribuição, a solicitação precisa usar o mesmo projeto do Google Cloud que a criou.
Posso responder a perguntas na API?
Ainda não. Você pode criar e modificar perguntas.
Complementos do Google Sala de Aula
Configuração do projeto
Posso converter um projeto privado do Google Cloud usado durante o desenvolvimento em um projeto público que possa ser usado na produção?
Não é possível converter um projeto privado do Google Cloud em um público. Você precisa de dois projetos separados, um para desenvolvimento e outro para produção.
Um único projeto do Google Cloud pode ter duas listagens no Google Workspace Marketplace?
Não. Não é possível criar duas listagens do Google Workspace Marketplace para um único projeto do Google Cloud.
No entanto, é possível agrupar complementos. Isso permite que uma única listagem do Google Workspace Marketplace represente vários complementos. A instalação a partir de uma lista desse tipo instalaria todos os complementos do pacote de uma só vez. Os usuários precisam consentir com todos os escopos necessários pelos complementos agrupados ao autorizar.
É possível reutilizar um cliente OAuth de um projeto do Google Cloud diferente com complementos do Google Cloud para o Google Sala de Aula?
Não, um cliente OAuth de um projeto do Google Cloud que não seja o projeto do Google Cloud do complemento do Google Sala de Aula não funciona. Os tokens de acesso gerados por outro projeto do Google Cloud são negados pela API Classroom. É necessário criar um cliente OAuth separado para o projeto do complemento.
Experiência do usuário
Nosso logotipo não se encaixa bem em um quadrado pequeno. Quais são as opções de tamanho para logotipos na barra de título do iframe?
A barra de título do iframe foi projetada para oferecer suporte apenas a um logotipo quadrado de 32 x 32. Essa escolha foi feita para corresponder à forma do ícone que as empresas usam nos sites e nossa orientação é usar o mesmo logotipo no espaço para manter a consistência da marca.
Domínios
Todos os professores e estudantes no mesmo domínio têm acesso a um complemento instalado?
Os administradores escolares podem controlar quais professores podem acessar um complemento instalado. Os complementos do Google Sala de Aula só podem ser usados por usuários com uma licença do Teaching & Learning ou do Education Plus.
Como os administradores de domínio interagem com os complementos?
Os administradores de domínio controlam quem pode usar o complemento. Eles podem instalar um complemento para um domínio inteiro usando a opção de instalação do administrador. Se o complemento puder ser instalado individualmente, saiba que a maioria dos administradores mantém uma lista de permissões de complementos. Os professores podem instalar complementos para si mesmos que estão nessa lista. Um administrador também pode optar por instalar o complemento individualmente para fins de teste.
Os administradores também podem ter interesse nas estatísticas de uso relacionadas ao seu complemento. Se o produto oferecer suporte, forneça estatísticas de uso do complemento em uma visualização de administrador no seu site.
API
Qual é uma maneira confiável de saber se a página do parceiro é carregada em um iframe ou em uma guia pop-out?
Não há um método atual para distinguir entre os dois.
Quais itens de trabalho atribuíveis recebem um iframe de análise do trabalho do estudante?
O iframe de análise de trabalhos dos estudantes só é fornecido para anexos do tipo atividade.
Chame o método courses.courseWork.getAddOnContext para revelar se o tipo de postagem
oferece suporte ao trabalho do estudante. O campo supportsStudentWork só pode ser true
para um tipo de postagem que seja uma atividade.
Um anexo de complemento pode acessar o item de transmissão a que está anexado?
Sim. Você pode get ou patch qualquer Announcement, CourseWork ou
CourseWorkMaterial que contenha pelo menos um dos seus anexos de complemento.
Você pode reclaim, return ou turnIn um CourseWork StudentSubmission.
Logon único
Os alunos que usam os selos do Clever ou o Classlink para fazer login no Chromebook podem usar o login do Google?
Sim, eles ainda podem usar o recurso "Fazer login com o Google".
Todos os estudantes têm um endereço de e-mail formatado corretamente, mesmo que não tenham acesso ao Gmail?
Todos os usuários do Google Workspace for Education têm uma identidade do Google, mesmo que não tenham acesso ao Gmail. As identidades são representadas por um endereço de e-mail. A identidade e o acesso a qualquer serviço do Google (incluindo o Gmail) são distintos. Portanto, mesmo que o Gmail esteja desativado, os usuários estudantes podem fazer login com o endereço de e-mail.
Um administrador da escola precisa pré-aprovar o app para permitir que os estudantes façam login?
Os administradores do domínio precisam adicionar à lista de permissões um complemento antes de instalá-lo. Opcionalmente, os administradores de domínio podem instalar um complemento para todos os usuários no domínio ou em uma unidade organizacional.
Feedback e perguntas gerais
Como posso enviar solicitações de recursos ou problemas?
É possível enviar, visualizar e votar nas solicitações de recursos no nosso Issue Tracker público.
Como saber quando novos recursos estão disponíveis na API Classroom?
As atualizações da API são publicadas na página de notas da versão, no nosso fórum para desenvolvedores e no Issue Tracker público.
Estou usando a API Classroom. Como posso fazer perguntas técnicas?
Poste suas perguntas no Stack Overflow com a tag google-classroom.