Embora qualquer desenvolvedor possa fazer solicitações à API Google Classroom, alguns recursos do Google Classroom só estão disponíveis para determinados usuários. Cada recurso pode ter requisitos diferentes, como um determinado tipo de licença do Google Workspace for Education. Para uma análise detalhada dos recursos em cada nível de licença do Google Workspace for Education, consulte 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 de complementos do Google Sala de Aula.
- Modificar as configurações do período de avaliação.
- Criar, modificar e excluir rubricas.
Determinar as funções do usuário
As solicitações à API Classroom são feitas em nome de usuários individuais. Portanto, verifique se um usuário tem as funcionalidades adequadas 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 adequado
para o recurso da Sala de Aula que você pretende usar. Especifique o Capability adequado 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 |
| 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 ao Capability escolhido. Depois, você pode fazer solicitações de API
relacionadas ao Capability em nome do usuário.