Method: courses.updateGradingPeriodSettings

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

Con este método, se pueden agregar, quitar o modificar períodos de calificación individuales.

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

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 en un curso o por errores de acceso:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.
  • 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)

Es una 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 incorporaciones, y se asignará un ID nuevo cuando se realice la solicitud.
  • Los períodos de calificación que existen actualmente, pero que no están 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 como están.
  • Si incluyes períodos de calificación con un ID desconocido, se generará 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. Se debe configurar para acceder a las nuevas funciones de la API que se ponen a disposición de 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.