Method: courses.announcements.patch

Atualiza um ou mais campos de um aviso.

Esse método retorna os seguintes códigos de erro:

  • PERMISSION_DENIED: se o projeto de desenvolvedor solicitante não tiver criado o aviso correspondente ou se houver erros de acesso.
  • INVALID_ARGUMENT se a solicitação for inválida.
  • FAILED_PRECONDITION se o aviso solicitado já tiver sido excluído.
  • NOT_FOUND se o curso ou o aviso solicitado não existirem

Solicitação HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
courseId

string

Identificador do curso. Esse identificador pode ser atribuído pelo Google Sala de Aula ou um alias.
id

string

Identificador do aviso.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara que identifica os campos a serem atualizados no aviso. Este campo é obrigatório para fazer uma atualização. A atualização falhará se campos inválidos forem especificados. Se um campo aceitar valores vazios, ele poderá ser apagado especificando-o na máscara de atualização e não no objeto de anúncio. Se um campo que não permite valores vazios for incluído na máscara de atualização e não for definido no objeto de anúncio, o erro INVALID_ARGUMENT será retornado.

Os professores podem especificar os seguintes campos:

  • text
  • state
  • scheduledTime

Esta é uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da solicitação

O corpo da solicitação contém uma instância de Announcement.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Announcement.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte o Guia de autorização.