Method: courses.checkGradingPeriodsSetupEligibility

Muestra si un usuario es apto para actualizar GradingPeriodSettings en un curso determinado.

Este método muestra los siguientes códigos de error:

  • PERMISSION_DENIED para errores de acceso
  • Es INVALID_ARGUMENT si la solicitud no tiene el formato correcto.
  • NOT_FOUND si el curso solicitado no existe.

Solicitud HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
courseId

string

Obligatorio. Es el identificador del curso.

Parámetros de consulta

Parámetros
previewVersion

enum (PreviewVersion)

Opcional. La versión preliminar de la API. Esto se debe establecer para acceder a las nuevas capacidades de la API que están disponibles para los desarrolladores en el Programa de versión preliminar.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Indica si el usuario puede actualizar GradingPeriodSettings en este curso.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
Campos
courseId

string

Inmutable. Es el identificador del curso.
isGradingPeriodsSetupEligible

boolean

Indica si el usuario puede actualizar la configuración del período de calificación en este curso.
previewVersion

enum (PreviewVersion)

Solo salida. La versión preliminar de la API. Esto se debe establecer para acceder a las nuevas capacidades de la API que están disponibles para los desarrolladores en el Programa de versión preliminar.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

Para obtener más información, consulta la Guía de autorización.