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 seguintes recursos da API Classroom estão disponíveis apenas para usuários qualificados:
- Criar e modificar anexos do complemento do Google Sala de Aula.
- Modificar as configurações do período de avaliação.
- Criar, modificar e excluir rúbricas.
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 um recurso específico, 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 |
|---|---|
| Pode criar ou modificar um anexo de complemento do Google Sala de Aula associado ao projeto do Google Cloud do ID do cliente OAuth usado para fazer a solicitação | CREATE_ADD_ON_ATTACHMENT |
| Pode modificar as configurações do período de avaliação | UPDATE_GRADING_PERIOD_SETTINGS |
| Pode criar, modificar ou excluir 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.