Method: courses.courseWork.patch

Actualiza uno o más campos de un trabajo del curso.

Consulta google.classroom.v1.CourseWork para obtener información sobre qué campos se pueden actualizar y quién puede modificarlos.

Esta solicitud la debe realizar el proyecto de Developer Console del ID de cliente de OAuth que se usó para crear el elemento de trabajo del curso correspondiente.

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

  • PERMISSION_DENIED si el proyecto de desarrollador solicitante no creó el trabajo del curso correspondiente, si el usuario no tiene permiso para realizar la modificación solicitada en la entrega del estudiante o si se presentan errores de acceso
  • Es INVALID_ARGUMENT si la solicitud no tiene el formato correcto.
  • FAILED_PRECONDITION si ya se borró el trabajo solicitado del curso.
  • NOT_FOUND si el curso o trabajo del curso solicitado no existe.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
courseId

string

Es el identificador del curso. Este identificador puede ser el asignado por Classroom o un alias.
id

string

Identificador del trabajo del curso.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Máscara que identifica qué campos del curso funcionan para actualizar. Este campo es obligatorio para realizar una actualización. La actualización falla si se especifican campos no válidos. Si un campo admite valores vacíos, se puede borrar si se lo especifica en la máscara de actualización y no en el objeto CourseWork. Si se incluye un campo que no admite valores vacíos en la máscara de actualización y no se establece en el objeto CourseWork, se mostrará un error INVALID_ARGUMENT.

Los profesores pueden especificar los siguientes campos:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Disponible en V1_20240401_PREVIEW y versiones posteriores.

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

Cuerpo de la respuesta

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

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

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