Method: courses.courseWork.studentSubmissions.patch

학생 제출물의 필드를 하나 이상 업데이트합니다.

업데이트할 수 있는 필드와 이를 변경할 수 있는 사용자에 관한 자세한 내용은 google.classroom.v1.StudentSubmission을 참고하세요.

이 요청은 해당 과정 작업 항목을 만드는 데 사용된 OAuth 클라이언트 ID의 개발자 콘솔 프로젝트 또는 해당 과정 작업 항목에 성적 동기화가 사용 설정된 애드온 첨부파일에서 실행해야 합니다.

이 메서드는 다음 오류 코드를 반환합니다.

  • PERMISSION_DENIED 요청 개발자 프로젝트에서 해당 과정 작업을 만들지 않았거나 성적 동기화가 사용 설정된 해당 과정 작업에 애드온 첨부파일을 만들지 않은 경우, 사용자에게 학생 제출물에 요청된 수정을 할 권한이 없는 경우 또는 액세스 오류가 발생한 경우입니다.
  • 요청 형식이 잘못된 경우 INVALID_ARGUMENT입니다.
  • 요청된 과정, 과정 작업 또는 학생 제출물이 존재하지 않는 경우 NOT_FOUND입니다.

HTTP 요청

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
courseId

string

과정의 식별자입니다. 이 식별자는 Classroom 할당 식별자 또는 alias일 수 있습니다.
courseWorkId

string

과정 작업의 식별자입니다.
id

string

학생 제출물의 식별자입니다.

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

업데이트할 학생 제출물의 필드를 식별하는 마스크입니다. 업데이트를 실행하려면 이 필드가 필요합니다. 잘못된 필드가 지정되면 업데이트가 실패합니다.

교사가 지정할 수 있는 필드는 다음과 같습니다.

  • draftGrade
  • assignedGrade

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

선택사항입니다. API의 미리보기 버전입니다. 미리보기 프로그램에서 개발자가 사용할 수 있는 새로운 API 기능에 액세스하려면 이 값을 설정해야 합니다.

요청 본문

요청 본문에 StudentSubmission의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 StudentSubmission의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.