Si bien cualquier desarrollador puede realizar solicitudes a la API de Google Classroom, algunas funciones de Google Classroom solo están disponibles para ciertos usuarios. Cada función puede tener requisitos diferentes, como tener un tipo de licencia de Google Workspace for Education específico. Para obtener un desglose detallado de las funciones en cada nivel de licencia de Google Workspace for Education, consulta la página de comparación de ediciones.
Funciones con requisitos de elegibilidad
Las siguientes funciones de la API de Classroom solo están disponibles para los usuarios que cumplen con los requisitos:
- Cómo crear archivos adjuntos de complementos de Classroom
- Cómo modificar la configuración del período de calificación
- Cómo crear, actualizar y borrar rúbricas
Cómo determinar las capacidades del usuario
Las solicitudes a la API de Classroom se realizan en nombre de usuarios individuales. Por lo tanto, debes verificar si un usuario tiene las capacidades adecuadas antes de emitir solicitudes a la API con requisitos de elegibilidad.
Para determinar si un usuario tiene una función en particular, realiza una solicitud a la API al método checkUserCapability. Incluye el tipo de Capability apropiado para la función de Classroom que deseas usar. Especifica el Capability apropiado para cada componente:
| Para ver si el usuario… | Capability |
|---|---|
| Tiene acceso a un complemento de Classroom que pertenece al proyecto de Google Cloud solicitante | CREATE_ADD_ON_ATTACHMENT |
| Puede modificar la configuración del período de calificación | UPDATE_GRADING_PERIOD_SETTINGS |
| Puede crear o modificar una rúbrica | CREATE_RUBRIC |
A continuación, verifica el campo allowed en la respuesta. Si allowed es true, el usuario tiene acceso al Capability elegido. Luego, puedes realizar solicitudes a la API relacionadas con Capability en nombre del usuario.