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, você pode 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 (como entregar, devolver, recuperar)
- 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 diários de classe, o 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 alunos concluem o trabalho, os aplicativos podem entregar os trabalhos, definir notas, anexar os trabalhos dos alunos e armazenar os trabalhos em pastas adequadas do Google Drive.
- Os usuários professores podem criar atividades com anexos de complementos no seu site ou aplicativo.
- Os 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 corretos do usuário. Os professores podem conferir, criar, anexar links a envios de atividades e definir notas. Os estudantes podem ver as atividades, anexar links aos registros das atividades, além de entregar e recuperar os envios. Os administradores
do domínio podem ver CourseWork, mas não têm permissões de gravação.
Que tipos de itens minha inscrição pode anexar a atividades ou envios?
Na API, é possível 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 desse tipo de listagem instala todos os complementos do pacote de uma só vez. Os usuários precisam consentir com todos os escopos necessários para o pacote de complementos 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. Você precisa criar um cliente OAuth separado para o projeto do complemento.
Experiência do usuário
Nosso logotipo não cabe bem em um quadrado pequeno. Quais são as opções de tamanho disponíveis 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 ao formato do favicon que as empresas usam nos sites delas, 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 do 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 seu complemento individualmente para fins de teste.
Os administradores também podem ter interesse nas estatísticas de uso relacionadas ao seu complemento. Se possível, forneça estatísticas de uso de complementos em uma visualização de administrador no seu próprio site.
API
Qual é uma maneira confiável de saber se a página do parceiro é carregada dentro de um iframe ou uma guia pop-up?
Não há um método atual para distinguir entre os dois.
Quais itens de trabalhos atribuíveis recebem um iframe de avaliação dos trabalhos dos alunos?
O iframe de análise de trabalhos dos estudantes é fornecido apenas para anexos do tipo atividade.
Chame o método courses.courseWork.getAddOnContext para revelar se o tipo de postagem é compatível com o 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?
Todo usuário do Google Workspace for Education tem uma identidade do Google, não importa o acesso ao Gmail ou não. 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 podem fazer login com o endereço de e-mail deles.
Um administrador da escola precisa pré-aprovar o app para permitir que os estudantes façam login?
Os administradores de 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 solicitar problemas?
Você pode enviar, visualizar e votar em solicitações de recursos no nosso rastreador de problemas público.
Como posso 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.