Method: courses.patch

Actualiza uno o más campos de un curso.

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

  • PERMISSION_DENIED si el usuario que realiza la solicitud no tiene permiso para modificar el curso solicitado o por errores de acceso.
  • NOT_FOUND si no existe un curso con el ID solicitado.
  • Es INVALID_ARGUMENT si se especifican campos no válidos en la máscara de actualización o si no se proporciona una.
  • FAILED_PRECONDITION para los siguientes errores de solicitud:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
id

string

Es el identificador del curso que se actualizará. Este identificador puede ser el que asignó Classroom o un alias.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Máscara que identifica qué campos del curso se deben actualizar. Este campo es obligatorio para realizar una actualización. La actualización fallará si se especifican campos no válidos. Los siguientes campos son válidos:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Nota: Los parches para ownerId se consideran efectivos de inmediato, pero en la práctica, la transferencia de la propiedad de todos los recursos afectados puede tardar en completarse.

Cuando se establece en un parámetro de consulta, este campo se debe especificar como

updateMask=<field1>,<field2>,...

Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Course.

Cuerpo de la respuesta

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

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.