Perguntas frequentes

Acessar, 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 conferir e gerenciar o trabalho em uma classe. Especificamente, é possível fazer o seguinte:

  • Acessar tarefas e perguntas (coletivamente chamadas de "CourseWork") para um usuário
  • Criar, modificar e excluir tarefas do curso
  • Anexe materiais (arquivos do Drive, vídeos do YouTube, links) ao CourseWork
  • Mudar o estado do envio de um estudante (como entregar, devolver, recuperar)
  • Definir a nota do envio de uma atividade
  • Anexe materiais (arquivos do Drive, vídeos do YouTube, links) aos envios dos estudantes.

Alguns exemplos de casos de uso do CourseWork:

  • Os diários de classe, o SIA ou os sistemas de relatórios podem sincronizar as atividades e notas do Google Sala de Aula com os aplicativos, eliminando a transferência manual de dados.
  • Os aplicativos de aprendizado podem criar novas atividades que aparecem no fluxo da turma. À medida que os estudantes concluem o trabalho, os aplicativos podem entregá-los, definir notas, anexar os trabalhos e armazenar o trabalho nas pastas apropriadas do Drive.
  • Professores podem criar atividades com anexos de complementos do seu site ou aplicativo.
  • Os alunos podem entregar as atividades que tiverem anexos de complementos.

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

Normalmente, um aplicativo só pode modificar o trabalho que ele cria. Em outras palavras, todas as solicitações da API de mutação de atribuição precisam usar o mesmo ID do projeto do Google Cloud armazenado no momento de 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 aviso, tarefa ou material que tenha um ou mais anexos de complementos. Um projeto do Cloud também pode entregar, recuperar ou retornar uma atribuição 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 ver atividades, criar atividades, anexar links aos envios e definir notas de envio. Os alunos podem acessar atividades, anexar links aos registros de tarefas e entregar e recuperar os envios. Os administradores do domínio podem ver o CourseWork, mas não têm permissões de gravação.

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

Com a API, é possível 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 as atividades criadas externamente usando o nome do produto do projeto do Google Cloud que criou o trabalho. É possível que os usuários relatem trabalhos criados externamente como indesejados, além de desconectar o aplicativo que criou o trabalho, revogando todas 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 "Compartilhar"?

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. Responder perguntas de forma programática está no nosso roteiro.

Complementos do Google Sala de Aula

Configuração do projeto

É possível converter o projeto privado do Google Cloud que usei 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 público. Você precisa de dois projetos separados, um para desenvolvimento e outro para produção.

Um projeto do Google Cloud pode ter duas fichas do GWM?

Não. Não é possível criar duas fichas do GWM para um único projeto do Google Cloud.

No entanto, é possível agrupar complementos. Isso permite que uma única listagem do GWM represente vários complementos. Com isso, todos os complementos do pacote serão instalados de uma só vez. Ao autorizar, os usuários precisam consentir com todos os escopos necessários para os complementos do pacote.

Há duas considerações adicionais sobre o agrupamento:

  1. Os complementos do Google Sala de Aula estão disponíveis apenas para assinantes do Teaching & Learning Upgrade ou da SKU do Education Plus.

  2. A API de complementos está no modo de acesso antecipado e é restrita aos desenvolvedores participantes e aos projetos do Google Cloud. Os complementos do pacote podem não funcionar como esperado se dependerem de projetos não participantes do Google Cloud.

Um cliente OAuth de um projeto diferente 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 que não seja o projeto do Google Cloud do complemento do Google Sala de Aula não pode funcionar. Os tokens de acesso gerados por outro projeto do Google Cloud são negados pela API Classroom. Crie 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 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 de favicon 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 alunos no mesmo domínio têm acesso a um complemento instalado?

Os administradores de escolas controlam quais professores podem ver um complemento instalado.

Como os administradores de domínio interagem com complementos?

Os administradores do domínio (administradores) controlam quem pode usar seu 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, a maioria dos administradores mantém uma lista de permissões de complementos. Os professores podem instalar os complementos que estão nessa lista. Um administrador também pode instalar individualmente seu complemento para fins de teste.

Os administradores também podem ter interesse nas estatísticas de uso do seu complemento. Se for compatível com seu produto, considere fornecer estatísticas de uso de complementos na visualização do administrador no seu próprio site.

API

Qual é uma forma 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 atribuíveis recebem um iframe de avaliação dos trabalhos dos estudantes?

O iframe de avaliação dos trabalhos dos estudantes só é fornecido para anexos de tipo de atividade. Chame o método courses.courseWork.getAddOnContext para revelar se o tipo de postagem aceita o trabalho dos estudantes. O campo supportsStudentWork só pode ser true para um tipo de postagem que seja uma atividade.

Pode haver alterações interruptivas na API durante o programa de acesso antecipado?

A API de complementos ainda está em desenvolvimento. Portanto, pode haver alterações interruptivas na API, fazendo com que solicitações concluídas antes falhem ou se comportem de maneira diferente. Você pode ser notificado sobre quaisquer alterações interruptivas com antecedência por meio do fórum de desenvolvedores.

Um anexo de complemento pode acessar o item do stream a que está anexado?

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

Quando os complementos do Google Sala de Aula serão lançados publicamente?

Os complementos do Google Sala de Aula estão disponíveis para todos os usuários finais desde o 2o semestre de 2022. A API de complementos deverá estar disponível para todos os desenvolvedores em algum momento em 2024.

Logon único

Sim, eles ainda podem usar o Login do Google.

Todos os estudantes têm um endereço de e-mail correto, mesmo que não tenham acesso ao Gmail?

Todo usuário do Google Workspace for Education tem uma identidade do Google, não importa se ele tem acesso ao Gmail. As identidades são representadas por um endereço de e-mail. A identidade e o acesso a qualquer serviço específico do Google (incluindo o Gmail) são distintos. Portanto, mesmo que o Gmail esteja desativado, os alunos podem fazer login com o próprio endereço de e-mail.

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

Os administradores do domínio precisam adicionar um complemento à lista de permissões para que ele possa ser instalado. Os administradores de domínio também 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 nas solicitações de recursos no nosso Issue Tracker público.

Como saber quando os novos recursos estiverem 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 de desenvolvedores e no Issue Tracker público.

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

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