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 diferentes requisitos, como tener un tipo de licencia de Google Workspace for Education determinado. Para obtener un desglose detallado de las funciones de 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
Determina 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 capability en particular, realiza una solicitud a la API al método checkUserCapability. Incluye el tipo de Capability adecuado para la función de Classroom que deseas usar. Especifica el Capability apropiado para cada componente:
| Para ver si el usuario… | Capability |
|---|---|
| Puede crear o modificar un archivo 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 del período de calificación. | UPDATE_GRADING_PERIOD_SETTINGS |
| Puede crear, modificar o borrar una rúbrica. | CREATE_RUBRIC |
Luego, revisa el campo allowed en la respuesta. Si allowed es true, el usuario tiene acceso a la Capability elegida. Luego, puedes realizar solicitudes a la API relacionadas con el Capability en nombre del usuario.