Method: courses.courseWork.patch

Atualiza um ou mais campos de um trabalho escolar.

Consulte google.classroom.v1.CourseWork para detalhes sobre quais campos podem ser atualizados e quem pode alterá-los.

Essa solicitação precisa ser feita pelo projeto do Console do desenvolvedor do ID do cliente OAuth usado para criar o item de trabalho escolar correspondente.

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

  • PERMISSION_DENIED se o projeto do desenvolvedor solicitante não criou o trabalho escolar correspondente, se o usuário não tiver permissão para fazer a modificação solicitada no envio do aluno ou para erros de acesso.
  • INVALID_ARGUMENT se a solicitação estiver malformada.
  • FAILED_PRECONDITION se o trabalho escolar solicitado já tiver sido excluído.
  • NOT_FOUND se o curso ou trabalho escolar solicitado não existir.

Solicitação HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{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 trabalho escolar.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

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

Os seguintes campos podem ser especificados pelos professores:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • 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 prévia da API. Isso precisa ser definido para acessar os novos recursos da API disponibilizados aos desenvolvedores no Programa de testes.

Corpo da solicitação

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

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

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