Elegibilidad del usuario

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.

Término clave: Un usuario apto tiene la capacidad de usar una función determinada de Classroom si cumple con los requisitos de la función.

Punto clave: La capacidad se determina por separado para cada usuario y puede cambiar con el tiempo. La elegibilidad de las funciones de algunas funciones de la API de Classroom puede diferir de las funciones correspondientes de la app de Google Classroom. Por ejemplo, se aplican ciertos requisitos de licencia cuando se crean, modifican o borran rúbricas con la API.

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.

Punto clave: Considera verificar las capacidades de los usuarios de forma proactiva para que puedas adaptar el aspecto o el comportamiento de tu producto para que coincida con las funciones de Classroom a las que pueden acceder.

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
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

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.

Importante: Incluso si un usuario es apto, es posible que falle una solicitud a la API que dependa de la elegibilidad. La elegibilidad implica que un usuario puede usar una función de Classroom, no que se realizará correctamente una solicitud específica.