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:
- Crear archivos adjuntos de complementos de Classroom
- Cómo modificar la configuración del período de calificación
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 tiene acceso a un complemento de Classroom que es propiedad del
proyecto de Google Cloud solicitante, pasa el valor
CREATE_ADD_ON_ATTACHMENT. - Para ver si el usuario puede modificar la configuración del período de calificación, pasa el
UPDATE_GRADING_PERIOD_SETTINGS.
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.