Method: courses.announcements.patch

Actualiza uno o más campos de un anuncio.

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

  • PERMISSION_DENIED si el proyecto del desarrollador solicitante no creó el anuncio correspondiente o si hubo errores de acceso.
  • Es INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.
  • FAILED_PRECONDITION si ya se borró el anuncio solicitado.
  • NOT_FOUND si el curso o anuncio solicitado no existe

Solicitud HTTP

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

string

Es el identificador del anuncio.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Máscara que identifica qué campos del anuncio 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, puedes borrarlos especificándolos en la máscara de actualización y no en el objeto Notificación. Si un campo que no admite valores vacíos se incluye en la máscara de actualización y no se establece en el objeto de anuncio, se muestra un error INVALID_ARGUMENT.

Los profesores pueden especificar los siguientes campos:

  • text
  • state
  • scheduledTime

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

Cuerpo de la respuesta

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

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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