Method: courses.courseWork.studentSubmissions.patch

Atualiza um ou mais campos dos envios de um estudante.

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

Essa solicitação precisa ser feita pelo projeto do Play 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 do 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 por erros de acesso.
  • INVALID_ARGUMENT se a solicitação for inválida.
  • NOT_FOUND se o curso, o trabalho do curso ou o envio do estudante solicitado não existirem.

Solicitação HTTP

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

courseWorkId

string

Identificador do trabalho do curso.

id

string

Identificador do envio do estudante.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara que identifica os campos que precisam ser atualizados no envio do estudante. Este campo é obrigatório para fazer uma atualização. A atualização falhará se campos inválidos forem especificados.

Os professores podem especificar os seguintes campos:

  • draftGrade
  • assignedGrade

Esta é 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 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 StudentSubmission.

Corpo da resposta

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

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

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