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 determinado tipo de licencia de Google Workspace for Education. 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:
- Crear y modificar archivos adjuntos de complementos de Classroom
- Modificar la configuración del período de calificación
- Crear, modificar 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 capacidad en particular, realiza una solicitud a la API con el método checkUserCapability. Incluye el tipo de Capability adecuado para la función de Classroom que deseas usar. Especifica el Capability adecuado para cada función:
| Para ver si el usuario… | Capability |
|---|---|
| Puede crear o modificar un adjunto del complemento de Classroom asociado con el proyecto de Google Cloud del ID de cliente de OAuth que se usó para realizar la solicitud. | CREATE_ADD_ON_ATTACHMENT |
| Puede modificar la configuración de los períodos de calificación | UPDATE_GRADING_PERIOD_SETTINGS |
| Puede crear, modificar o borrar 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 el Capability en nombre del usuario.