Embora qualquer desenvolvedor possa fazer solicitações para a API Google Classroom, alguns recursos do Google Classroom estão disponíveis apenas para determinados usuários. Cada recurso pode ter requisitos diferentes, como 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
Determinar as capacidades do usuário
As solicitações para a 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 tem acesso a um complemento do Google Sala de Aula que pertence ao projeto do Google Cloud que está solicitando, transmita o valor
CREATE_ADD_ON_ATTACHMENT. - Para ver se o usuário pode modificar as configurações do período de avaliação, transmita o
UPDATE_GRADING_PERIOD_SETTINGS.
Em seguida, verifique o campo allowed na resposta. Se allowed for true, o usuário terá acesso ao Capability escolhido. É possível fazer solicitações de API
relacionadas ao Capability em nome do usuário.