Method: courses.topics.patch

Atualiza um ou mais campos de um tópico.

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

  • PERMISSION_DENIED se o projeto do desenvolvedor solicitante não criou o tópico correspondente ou para erros de acesso.
  • INVALID_ARGUMENT se a solicitação estiver incorreta.
  • FAILED_PRECONDITION se houver um tópico no curso com o mesmo nome.
  • NOT_FOUND, se o curso ou tópico solicitado não existir

Solicitação HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{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 o atribuído pelo Google Sala de Aula ou um alias.
id

string

Identificador do tópico.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara que identifica quais campos do tópico serão atualizados. Este campo é obrigatório para fazer uma atualização. A atualização falha se campos inválidos forem especificados. Se um campo aceitar valores vazios, ele poderá ser limpo especificando-o na máscara de atualização e não no objeto do tema. Se um campo que não oferece suporte a valores vazios for incluído na máscara de atualização e não for definido no objeto do tópico, um erro INVALID_ARGUMENT será retornado.

Os seguintes campos podem ser especificados:

  • name

É 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 Topic.

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

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