Qualificação do usuário

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.