이제 Google 클래스룸 부가기능이 일반적으로 개발자에게 제공됩니다. 자세한 내용은
부가기능 문서를 참고하세요.
Method: courses.courseWork.studentSubmissions.reclaim
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
제출물의 소유자인 학생을 대신하여 학생 제출물을 복구합니다.
학생 제출물을 복구하면 첨부된 Drive 파일의 소유권이 학생에게 이전되고 제출 상태가 업데이트됩니다.
요청된 학생 제출물을 소유한 학생만 이 메서드를 호출할 수 있으며, 제출된 학생 제출물에 대해서만 호출할 수 있습니다.
이 요청은 해당 과정 작업 항목을 만드는 데 사용된 OAuth 클라이언트 ID의 개발자 콘솔 프로젝트에서 해야 합니다.
이 메서드는 다음 오류 코드를 반환합니다.
PERMISSION_DENIED: 요청한 사용자가 요청된 과정 또는 과정 작업에 액세스할 수 없거나, 요청된 학생 제출물을 취소하거나, 액세스 오류가 발생한 경우- 학생 제출물이 제출되지 않은 경우
FAILED_PRECONDITION입니다.
INVALID_ARGUMENT: 요청 형식이 잘못된 경우- 요청된 강의, 강의 과제 또는 학생 제출물이 없는 경우
NOT_FOUND입니다.
HTTP 요청
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
courseId |
string
과정의 식별자입니다. 이 식별자는 클래스룸에서 할당한 식별자 또는 alias일 수 있습니다.
|
courseWorkId |
string
수업 과제의 식별자입니다.
|
id |
string
학생 제출물의 식별자입니다.
|
응답 본문
성공하면 응답 본문은 빈 JSON 객체입니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/classroom.coursework.me
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Method: courses.courseWork.studentSubmissions.reclaim\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReclaims a student submission on behalf of the student that owns it.\n\nReclaiming a student submission transfers ownership of attached Drive files to the student and updates the submission state.\n\nOnly the student that owns the requested student submission may call this method, and only for a student submission that has been turned in.\n\nThis request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, unsubmit the requested student submission, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `FAILED_PRECONDITION` if the student submission has not been turned in.\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course, course work, or student submission does not exist.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n| `courseWorkId` | `string` Identifier of the course work. |\n| `id` | `string` Identifier of the student submission. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.me`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
