Method: courses.announcements.patch

Actualiza uno o más campos de un anuncio.

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

  • PERMISSION_DENIED si el proyecto desarrollador solicitante no creó el anuncio correspondiente o por errores de acceso .
  • INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.
  • FAILED_PRECONDITION si el anuncio solicitado ya se eliminó.
  • 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 transcodificación de gRPC .

Parámetros de ruta

Parámetros
courseId

string

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

id

string

Identificador del anuncio.

Parámetros de consulta

Parámetros
updateMask

string ( FieldMask format)

Máscara que identifica qué campos del anuncio 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 Anuncio. 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 Anuncio, se devuelve un error INVALID_ARGUMENT .

Los siguientes campos pueden ser especificados por los profesores:

  • text
  • state
  • scheduledTime

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

cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Announcement .

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Announcement .

Ámbitos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulte la Descripción general de OAuth 2.0 .