Perguntas frequentes

Ver, criar e modificar tarefas do curso no Google Sala de Aula

O que posso criar com os endpoints do CourseWork na API Classroom?

Com os novos endpoints, os desenvolvedores podem visualizar e gerenciar trabalhos em uma turma. Especificamente: faça o seguinte:

  • Ver 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 tarefa
  • Anexar materiais (arquivos do Drive, vídeos do YouTube, links) a envios dos estudantes

Alguns exemplos de casos de uso de CourseWork:

  • Os diários de classe, o SIA ou os sistemas de relatórios podem sincronizar atividades e notas de o Google Sala de Aula aos aplicativos, eliminando os dados manuais transferência
  • Os aplicativos de aprendizagem podem criar novas atividades que aparecem na turma riacho. À medida que os alunos concluem o trabalho, os aplicativos podem entregá-lo, definir notas, anexar trabalhos de estudantes e armazenar trabalhos Pastas do Google Drive.
  • Os professores podem criar atividades com anexos de complementos do seu site ou aplicativo.
  • Os estudantes podem entregar atividades que têm seu complemento. anexos.

Que permissões meu aplicativo precisa para criar ou modificar atribuições?

Normalmente, um aplicativo só pode modificar o trabalho que cria. Em outras palavras, qualquer solicitação de API de mutação de atribuição precisa usar o mesmo ID do projeto do Google Cloud que estava armazenado no momento de criação da atividade.

Os complementos do Google Sala de Aula têm uma exceção a essa regra. Um o projeto do Google Cloud pode acessar ou modificar qualquer aviso, atribuição ou material com um ou mais anexos de complementos. Um do Google Cloud também pode entregar, recuperar ou devolver uma atribuição que tem um ou mais anexos de complementos.

As solicitações de API também exigem os escopos corretos do usuário. Os professores podem visualizar tarefas, criar tarefas, anexar links para envios de tarefas e definir notas de envios. Os estudantes podem acessar as atividades e anexar links para registros de atividades e entregar e recuperar os envios. Domínio os administradores podem ver CourseWork, mas não têm permissão de gravação.

Que tipos de itens minha inscrição pode anexar a atividades ou envios?

A API permite anexar arquivos do Google Drive, vídeos do YouTube e links. Ainda não é possível anexar Formulários Google nativos.

Os usuários finais sabem que uma atividade no Google Sala de Aula foi criada pelo meu aplicativo?

Sim. A interface do Google Sala de Aula identifica atividades criadas externamente. usando o nome do produto do projeto do Google Cloud que criou o trabalho. Os usuários podem denunciar trabalhos criados externamente como indesejados, bem como desconectar aplicativo que criou o trabalho, revogando todas as credenciais emitidas para pelo usuário.

Botão de compartilhamento do Google Sala de Aula e outras integrações

Já fiz a integração com o botão de compartilhamento do Google Sala de Aula. Posso modificar uma atribuição criada usando o botão de compartilhamento?

Ainda não. Para modificar uma atribuição, a solicitação precisa usar o mesmo serviço o projeto que criou a atribuição.

Posso responder a perguntas na API?

Ainda não. Você pode criar e modificar perguntas. Responder perguntas programaticamente está nos nossos planos.

Complementos do Google Sala de Aula

Configuração do projeto

Posso converter um projeto privado do Google Cloud que usei durante o desenvolvimento em um projeto público para usar na produção?

Não é possível converter um projeto particular do Google Cloud em um projeto público. Você precisa de duas projetos separados, um para desenvolvimento e outro para produção.

Um projeto do Google Cloud pode ter duas fichas de empresa do Google Workspace Marketplace?

Não. Não é possível criar duas fichas de empresa do Google Workspace Marketplace um único projeto do Google Cloud.

No entanto, é possível agrupar complementos. Isso permite que um único Ficha do Google Workspace Marketplace para representar vários complementos. Instalação de uma listagem instalam todos os complementos do pacote em uma vez. Os usuários precisam consentir com todos os escopos necessários para o pacote de complementos ao autorizar.

Um cliente OAuth de outro projeto do Google Cloud pode ser reutilizado com um projeto do Google Cloud para complementos do Google Sala de Aula?

Não, um cliente OAuth de um projeto do Google Cloud diferente do O projeto do Google Cloud do complemento do Google Sala de Aula não está funcionando. 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 iframe foi projetada para suportar somente um logotipo quadrado de 32 x 32. Isso foi feita para corresponder ao formato do favicon usado pelas empresas nos sites É nossa orientação usar o mesmo logotipo 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 controlam quais professores podem ver do complemento instalado. Os complementos do Google Sala de Aula só podem ser usados pelos usuários com o curso Teaching and Learning ou 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 instalação do administrador . Se o complemento puder ser instalado individualmente, observe que a maioria Os administradores mantêm uma lista de permissões de complementos. os professores podem instalar complementos para que estão nessa lista. Um administrador também pode optar instalar o complemento individualmente para fins de teste.

Os administradores também podem ter interesse em estatísticas de uso relacionadas aos seus . Se possível, envie estatísticas de uso do complemento em uma visualização de administrador no seu site.

API

Qual é a maneira confiável de saber se a página do parceiro está carregada em um iframe ou em uma guia pop-out?

Não existe 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 "Revisão dos trabalhos dos alunos" só é fornecido para anexos do tipo atividade. Chame o método courses.courseWork.getAddOnContext para revelar se a postagem oferece suporte aos trabalhos dos estudantes. O campo supportsStudentWork pode ser apenas true para um tipo de postagem que é uma atividade.

Um anexo de complemento pode acessar o item de stream ao qual está anexado?

Sim. Você pode get ou patch qualquer Announcement, CourseWork ou CourseWorkMaterial que tenha pelo menos um dos seus anexos de complementos. Você pode reclaim, return ou turnIn um CourseWork StudentSubmission.

Logon único

Sim, eles ainda podem usar o Login do Google.

Todos os alunos 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 independentemente de eles terem acesso ao Gmail. As identidades são representadas por um e-mail endereço IP. Identidade e acesso a qualquer Serviço do Google específico (incluindo o Gmail) são diferentes. Portanto, mesmo que o Gmail esteja desativado, os usuários estudantes podem fazer login com o endereço de e-mail deles.

O administrador da escola precisa pré-aprovar o app para permitir que os estudantes façam login?

Os administradores do domínio precisam colocar um complemento na lista de permissões para que ele seja instalado. Opcionalmente, os administradores do domínio podem instalar um complemento para todos os usuários no domínio ou uma unidade organizacional.

Feedback e dúvidas gerais

Como posso enviar solicitações de recursos ou solicitar problemas?

Você pode enviar, visualizar e votar em solicitações de recursos em nossa edição pública rastreador.

Como posso saber quando novos recursos estão disponíveis na API Classroom?

As atualizações da API são postadas na página de notas da versão, no nosso fórum de desenvolvedores e o 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.