Embora qualquer desenvolvedor possa fazer solicitações para a API Google Sala de Aula, alguns recursos do Google Sala de Aula estão disponíveis apenas para determinados usuários. Cada recurso pode ter requisitos diferentes, como ter um determinado tipo de licença do Google Workspace for Education. Para conferir um detalhamento dos recursos em cada nível de licença do Google Workspace for Education, acesse a página de comparação de edições.
Recursos com requisitos de qualificação
Os recursos da API Classroom abaixo estão disponíveis apenas para usuários qualificados:
- Como criar anexos de complementos do Google Sala de Aula
- Como modificar as configurações do período de avaliação
- Criar, atualizar e excluir rubricas
Determinar os recursos do usuário
As solicitações à API Classroom são feitas em nome de usuários individuais. Portanto, verifique se um usuário tem os recursos adequados antes de emitir solicitações de API com requisitos de qualificação.
Para determinar se um usuário tem uma capacidade específica, faça uma solicitação de API para
o método checkUserCapability. Inclua o tipo Capability apropriado
para o recurso do Google Sala de Aula que você pretende usar. Especifique o
Capability apropriado para cada recurso:
| Para saber se o usuário... | Capability |
|---|---|
| Tem acesso a um complemento do Google Sala de Aula que pertence ao projeto do Google Cloud que fez a solicitação | CREATE_ADD_ON_ATTACHMENT |
| Pode modificar as configurações do período de avaliação | UPDATE_GRADING_PERIOD_SETTINGS |
| Pode criar ou modificar uma rubrica | CREATE_RUBRIC |
Em seguida, verifique o campo allowed na resposta. Se allowed for true, o usuário terá acesso à Capability escolhida. Em seguida, é possível fazer solicitações de API
relacionadas ao Capability em nome do usuário.