Method: courses.updateGradingPeriodSettings

Actualiza la configuración del período de calificación de un curso.

El usuario solicitante y el propietario del curso deben ser aptos para modificar los Períodos de calificación. Para obtener más información, consulta los requisitos de licencia.

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para modificar la configuración del período de calificación de un curso o por errores de acceso:
    • UserIneligibleToUpdateGradingPeriodSettings
  • Es INVALID_ARGUMENT si la solicitud no tiene el formato correcto.
  • NOT_FOUND si el curso solicitado no existe.

Solicitud HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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
updateMask

string (FieldMask format)

Máscara que identifica qué campos de GradingPeriodSettings se deben actualizar.

La lista gradingPeriods de GradingPeriodSettings se reemplazará por completo por los períodos de calificación especificados en la solicitud de actualización. Por ejemplo:

  • Los períodos de calificación incluidos en la lista sin un ID se consideran adiciones, y se asignará un ID nuevo cuando se realice la solicitud.
  • Los períodos de calificación que existen actualmente, pero que faltan en la solicitud se considerarán eliminaciones.
  • Los períodos de calificación con un ID existente y datos modificados se consideran ediciones. Los datos no modificados se dejarán tal como están.
  • Los períodos de calificación incluidos con un ID desconocido generarán un error.

Se pueden especificar los siguientes campos:

  • gradingPeriods
  • applyToExistingCoursework

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
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 contiene una instancia de GradingPeriodSettings.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de GradingPeriodSettings.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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