Method: courses.courseWork.patch

Actualiza uno o más campos de un trabajo de clase.

Consulta google.classroom.v1.CourseWork para obtener detalles sobre qué campos se pueden actualizar y quién puede cambiarlos.

Esta solicitud debe realizarla el proyecto de la Consola para desarrolladores del ID de cliente de OAuth que se usó para crear el elemento de trabajo de clase correspondiente o un adjunto de complemento en el elemento de trabajo de clase correspondiente.

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

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

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

Parámetros
courseId

string

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

string

Es el identificador del trabajo de clase.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Es la máscara que identifica qué campos del trabajo de clase se deben 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 especificándolo en la máscara de actualización y no en el objeto CourseWork. Si se incluye en la máscara de actualización un campo que no admite valores vacíos y no se configura en el objeto CourseWork, se muestra un error INVALID_ARGUMENT.

Los profesores pueden especificar los siguientes campos:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • learningGoals

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

enum (PreviewVersion)

Es opcional. Es la versión preliminar de la API. Se debe configurar 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.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

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