Method: courses.topics.patch

Actualiza uno o más campos de un tema.

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

  • PERMISSION_DENIED si el proyecto del desarrollador solicitante no creó el tema correspondiente o por errores de acceso.
  • INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.
  • NOT_FOUND si el curso o tema solicitado no existe

Solicitud HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{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

Es el identificador del tema.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Es una máscara que identifica qué campos del tema se deben actualizar. Este campo es obligatorio para realizar una actualización. La actualización fallará si se especifican campos no válidos. Si un campo admite valores vacíos, se puede borrar especificando la máscara de actualización y no el objeto Topic. 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 Topic, se muestra un error INVALID_ARGUMENT.

Se pueden especificar los siguientes campos:

  • name

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Topic.

Cuerpo de la respuesta

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

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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