Method: courses.courseWorkMaterials.patch

Atualiza um ou mais campos de um material de trabalho do curso.

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

  • PERMISSION_DENIED se o projeto de desenvolvedor solicitante tiver erros de acesso.
  • INVALID_ARGUMENT se a solicitação estiver malformada.
  • FAILED_PRECONDITION se o material de trabalho do curso solicitado já tiver sido excluído.
  • NOT_FOUND se o curso ou o material de trabalho do curso solicitado não existir.

Solicitação HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{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 material de trabalho do curso.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara que identifica quais campos do material de trabalho do curso serão atualizados. Esse 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 de material de trabalho do curso. Se um campo que não aceita valores vazios for incluído na máscara de atualização e não definido no objeto de material de trabalho do curso, um erro INVALID_ARGUMENT será retornado.

Os seguintes campos podem ser especificados pelos professores:

  • title
  • description
  • state
  • scheduledTime
  • topicId
  • learningGoals

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

enum (PreviewVersion)

Opcional. A versão de visualização do endpoint.

PREVIEW_VERSION_9001 inclui novos recursos: * Atualizações de materiais são aceitas. Para atualizar materiais, use a máscara de atualização "materials". A lista de materiais fornecida no objeto CourseWorkMaterial da solicitação vai substituir totalmente a lista atual. O campo de materiais pode ser limpo especificando "materials" na máscara de atualização e não no objeto CourseWorkMaterial. No momento, atualizações de CourseWorkMaterial PUBLICADO estão indisponíveis.

Corpo da solicitação

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

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

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