Pré-requisitos

Todas as integrações do Google Workspace dependem do Google Cloud para configurar o acesso à API, processar a autenticação e a autorização e gerenciar aplicativos. Talvez você também precise ter acesso ao Google Sala de Aula para testar a integração. Neste guia, descrevemos como solicitar e configurar esses recursos.

Configure um projeto do Google Cloud

Importante: é necessário usar um projeto do Google Cloud para gerenciar uma integração do Google Sala de Aula. Não é necessário usar recursos pagos do Google Cloud para usar a API Classroom.

Siga as etapas para começar para desenvolvedores do Google Workspace. Essas etapas são obrigatórias para todas as integrações do Google Workspace.

Testar contas e domínios

Importante: embora as contas padrão do Gmail possam acessar o Google Sala de Aula, você vai precisar de um domínio de demonstração se estiver tentando testar comportamentos que se aplicam apenas a usuários do Google Workspace for Education, como recursos especiais de administrador.

Os domínios de demonstração são contas de teste para integrações com a API Classroom. Um domínio de demonstração representa uma escola fictícia com uma assinatura do Google Workspace for Education que pode ser usada para desenvolver e testar integrações sem afetar os usuários reais.

É possível receber um domínio de teste para testar recursos de administrador ou para desenvolvimento com a API Classroom.

Receber um domínio de teste administrativo

Você pode usar um ambiente de demonstração pré-criado se precisar testar apenas as permissões de administrador da API. Isso inclui, por exemplo, a criação de cursos em nome de professores.

Para usar o ambiente pré-criado, participe do Programa Google Cloud Partner Advantage. Os membros recebem acesso à página Google for Education do Partner Advantage. Esta página descreve como acessar nosso ambiente de demonstração pré-criado do Google Workspace for Education, que pode ser usado para demonstrações de clientes, solução de problemas de produtos, testes de recursos e muito mais.

Receber um domínio de demonstração para desenvolvedores

Para fazer solicitações em nome de usuários de professores e estudantes, você precisa criar e gerenciar seu próprio domínio de demonstração do Google Workspace for Education. Os domínios de demonstração incluem uma licença permanente e sem custo financeiro do Google Workspace for Education Fundamentals. É possível adicionar mais produtos ao domínio conforme necessário.

Siga as etapas abaixo para receber um domínio de demonstração para desenvolvedores.

1. Compre um domínio no formato gedu.demo.YOUR DOMAIN. Por exemplo, uma organização que opera o domínio myedtech.com precisa criar gedu.demo.myedtech.com. Os domínios de demonstração precisam seguir este formato.
2. Verifique se você é o proprietário do domínio de demonstração.

3. Inscrever-se no Google Workspace for Education usando o domínio de demonstração. Isso inicia um período de teste de duas semanas.

   Importante: o novo domínio precisa ser principal do Google Workspace. Isso significa que seu domínio de demonstração não pode ser um subdomínio de um domínio do Google Workspace, que são chamados de secundários. O Google não pode conceder uma licença de demonstração a um domínio secundário. Consulte os artigos da Central de Ajuda Escolher seu domínio principal e Mudar seu domínio principal para mais informações sobre como gerenciar domínios usados no Google Workspace.

4. Preencha este formulário para notificar o Google sobre o registro do seu domínio. Todas as solicitações de domínios de demonstração são analisadas por um gerente de parcerias.

5. Se você estiver desenvolvendo uma integração que usa recursos pagos do Google Sala de Aula, solicite um upgrade do domínio de demonstração.

6. Faça login no Google Admin Console usando a conta de administrador especificada ao se inscrever no Google Workspace for Education. Em seguida, crie novos usuários de domínio de demonstração. Recomendamos criar pelo menos três usuários adicionais: um para atuar como professor e dois estudantes.

7. Faça login no Google Sala de Aulaclassroom-site usando uma nova conta de professor. Crie uma turma e adicione suas novas contas de estudante.

Observação: recomendamos criar perfis separados para os usuários do domínio de demonstração para que você possa alternar rapidamente entre eles ao usar o domínio de demonstração.

Solicitar um upgrade de domínio de demonstração para recursos premium

Importante: alguns recursos do Google Sala de Aula exigem uma licença paga do Google Workspace for Education. Solicite um upgrade do seu domínio de demonstração para testar uma integração que depende desses recursos.

Os usuários precisam ter uma licença adequada do Google Workspace for Education para usar integrações que afetam ou dependem de recursos premium do Google Sala de Aula. Confira os recursos:

• Complementos do Google Sala de Aula
• Períodos de avaliação
• Escalas de avaliação
• Exportação de notas
• Sincronização de listas de estudantes
• Rubricas

Consulte a página Licenças do Google Workspace for Education para conferir a lista completa de recursos disponíveis em cada nível de assinatura.

Se a integração usar algum desses recursos, siga as etapas abaixo para solicitar um upgrade de domínio de demonstração. Um domínio atualizado vai receber 10 licenças sem custo financeiro do Google Workspace for Education Plus para atribuir aos usuários de teste.

1. Conclua as etapas para receber um domínio de demonstração para desenvolvedores, caso ainda não tenha feito isso.
2. Preencha e envie o formulário de solicitação de upgrade de domínio de demonstração. O envio deste formulário solicita que o Google faça upgrade do seu domínio de demonstração para o Google Workspace for Education Plus com dez licenças.
3. Você vai receber um e-mail quando o processo de upgrade for concluído.
4. Atribua licenças Plus às suas contas de professores de teste no Admin Console do domínio de demonstração atualizado.
   1. Em Directory > Users, crie ou selecione as contas de professores de teste.
   2. Nas Licenças de cada professor, confirme se o Google Workspace for Education Plus está atribuído.