Method: courses.courseWorkMaterials.patch

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

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

  • PERMISSION_DENIED si el proyecto de desarrollador solicitante tiene errores de acceso.
  • INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.
  • FAILED_PRECONDITION si el material de trabajo del curso solicitado ya se borró.
  • NOT_FOUND si el curso o el material de trabajo del curso solicitados no existen.

Solicitud HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{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 que asignó Classroom o un alias.
id

string

Es el identificador del material de trabajo del curso.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Es la máscara que identifica qué campos del material de trabajo del curso se actualizarán. 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 de material de trabajo del curso. 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 de material de trabajo del curso, se muestra un error INVALID_ARGUMENT.

Los profesores pueden especificar los siguientes campos:

  • title
  • description
  • state
  • scheduledTime
  • topicId

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 del extremo.

PREVIEW_VERSION_9001 incluye nuevas funciones: * Se admiten actualizaciones de materiales. Para actualizar materiales, usa la máscara de actualización "materials". La lista de materiales proporcionada en el objeto CourseWorkMaterial de la solicitud reemplazará por completo la lista existente. El campo de materiales se puede borrar especificando "materials" en la máscara de actualización y no en el objeto CourseWorkMaterial. Por el momento, no se admiten actualizaciones de CourseWorkMaterial PUBLICADO.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de CourseWorkMaterial.

Cuerpo de la respuesta

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

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

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