Perguntas frequentes

Como ver, criar e modificar atividades no Google Sala de Aula

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

Os endpoints permitem que os desenvolvedores vejam e gerenciem trabalhos em uma turma. Especificamente, é possível fazer o seguinte:

  • Ver atividades e perguntas (coletivamente chamadas de CourseWork) de um usuário.
  • Criar, modificar e excluir CourseWork.
  • Anexe materiais (arquivos do Drive, vídeos do YouTube, links) a CourseWork.
  • Mudar o estado do envio de um estudante (como entrega, devolução, recuperação).
  • Defina a nota de um envio de atividade.
  • Anexar materiais (arquivos do Drive, vídeos do YouTube, links) às atividades enviadas pelos estudantes.

Alguns exemplos de casos de uso para CourseWork:

  • Os boletins, SIAs ou 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 aprendizado podem criar atividades que aparecem no mural da turma. À medida que os estudantes concluem os trabalhos, os aplicativos podem entregar as atividades, definir notas, anexar os trabalhos dos estudantes e armazenar as atividades nas pastas adequadas do Drive.
  • Os professores podem criar atividades com anexos de complementos do seu site ou aplicativo.
  • Os estudantes podem entregar as atividades com anexos do complemento.

Quais permissões meu aplicativo precisa para criar ou modificar atividades?

Normalmente, um aplicativo só pode modificar o trabalho que ele cria. Em outras palavras, qualquer solicitação de API para modificar CourseWork precisa usar o mesmo ID do projeto do Google Cloud que foi usado para criar o CourseWork.

Os complementos do Google Sala de Aula têm uma exceção a essa regra. Um projeto do Cloud pode acessar ou modificar qualquer aviso, atividade ou material que tenha um ou mais anexos de complemento. Um projeto do Cloud 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 ver e criar atividades, anexar links aos envios e definir notas. Os estudantes podem ver as atividades, anexar links aos registros delas e entregar e recuperar os envios. Os administradores do domínio podem ver CourseWork, mas não têm permissões de gravação.

Quais tipos de itens meu aplicativo pode anexar a atividades ou envios?

A API permite anexar arquivos do 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 e desconectar o aplicativo que criou o trabalho revogando as credenciais emitidas para o aplicativo 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 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. É possível 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 em produção?

Não, não é possível converter um projeto particular 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 páginas do Google Workspace Marketplace para um único projeto do Google Cloud.

No entanto, é possível agrupar complementos. Assim, uma única listagem do Google Workspace Marketplace pode representar vários complementos. A instalação de uma listagem desse tipo instala todos os complementos do pacote de uma só vez. Os usuários precisam dar consentimento a todos os escopos necessários para os complementos agrupados ao autorizar.

É possível reutilizar um cliente OAuth de um projeto do Google Cloud diferente com um projeto do Google Cloud para complementos da Sala de Aula?

Não, um cliente OAuth de um projeto do Google Cloud diferente do projeto do Google Cloud do complemento do Google Sala de Aula não funciona. 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 logo não se encaixa bem em um quadrado pequeno. Quais são as opções de tamanho para logos na barra de título do iframe dos complementos do Google Sala de Aula?

A barra de título do iframe foi projetada para aceitar apenas um logotipo quadrado de 32x32. Essa escolha foi feita para corresponder ao formato do favicon usado pelas empresas nos sites. 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 de domínio podem controlar quais professores podem ver um complemento instalado. Os complementos do Google Sala de Aula só podem ser usados por usuários com a 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 seu complemento. Eles podem instalar um complemento para todo o domínio usando a opção de instalação do administrador. Se o complemento puder ser instalado individualmente, observe que a maioria dos administradores mantém uma lista de permissões de complementos. Os professores que estão nessa lista podem instalar complementos por conta própria. Um administrador também pode optar por instalar individualmente seu complemento para fins de teste.

Os administradores também podem ter interesse em estatísticas de uso relacionadas ao seu complemento. Se o produto permitir, considere fornecer estatísticas de uso de complementos em uma visualização de administrador no seu site.

API

Qual é uma maneira confiável de saber se o conteúdo dos complementos é carregado em um iframe ou em uma nova guia?

Não há um método atual para distinguir entre os dois.

Quais itens de trabalho atribuíveis recebem um iframe de revisão de 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 saber se o tipo de postagem aceita trabalhos dos estudantes. 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 stream a que está anexado?

Sim. Você pode get ou patch qualquer Announcement, CourseWork ou CourseWorkMaterial que contenha pelo menos um dos anexos do complemento. Você pode reclaim, return ou turnIn um CourseWork StudentSubmission.

Logon único

Sim, eles ainda podem usar o Google Sign-In.

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. A identidade e o acesso a qualquer Serviço do Google específico (incluindo o Gmail) são distintos. Mesmo que o Gmail esteja desativado, os estudantes podem fazer login no Google Sala de Aula com o endereço de e-mail. As identidades são representadas por um ID de usuário e um endereço de e-mail. Um usuário do Google Workspace for Education pode mudar o endereço de e-mail. Por isso, recomendamos que você use IDs de usuário como chaves primárias ao armazenar informações do usuário.

Um administrador escolar precisa pré-aprovar o app para permitir que os estudantes façam login?

Os administradores de domínio precisam colocar na lista de permissões um complemento antes que ele possa ser instalado. Os administradores de domínio também podem instalar um complemento para todos os usuários do domínio ou de uma unidade organizacional.

Feedback e dúvidas gerais

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

Você pode enviar, visualizar e votar em solicitações de recursos no nosso Issue Tracker público.

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

As atualizações da API são postadas na newsletter para desenvolvedores e no Rastreador de problemas público.

Estou usando a API Classroom. Como posso fazer perguntas técnicas?

Poste suas perguntas no Stack Overflow com a tag google-classroom.