Method: courses.courseWork.patch

Atualiza um ou mais campos do trabalho de um curso.

Acesse google.classroom.v1.CourseWork para conferir detalhes sobre quais campos podem ser atualizados e quem pode fazer mudanças.

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

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

  • PERMISSION_DENIED se o projeto de desenvolvedor solicitante não tiver criado o trabalho do curso correspondente, se o usuário não tiver permissão para fazer a modificação solicitada no envio do estudante ou devido a erros de acesso.
  • INVALID_ARGUMENT se a solicitação estiver incorreta.
  • FAILED_PRECONDITION se o trabalho do curso solicitado já tiver sido excluído.
  • NOT_FOUND se o curso ou trabalho 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 atribuído ao Google Sala de Aula ou alias.
id

string

Identificador do trabalho do curso.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara que identifica quais campos do curso precisam ser atualizados. Este campo é obrigatório para fazer uma atualização. A atualização falhará se campos inválidos forem especificados. Se um campo oferecer suporte a valores vazios, ele poderá ser apagado especificando na máscara de atualização e não no objeto CourseWork. Se um campo incompatível com valores vazios estiver incluído na máscara de atualização e não for definido no objeto CourseWork, será retornado um erro INVALID_ARGUMENT.

Os seguintes campos podem ser especificados pelos professores:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Disponível em V1_20240401_PREVIEW e versões mais recentes.

É 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é-lançamento da API. Isso precisa ser definido para acessar as novas funcionalidades da API disponibilizadas para os 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.