이제 Google 클래스룸 부가기능이 일반적으로 개발자에게 제공됩니다. 자세한 내용은
부가기능 문서를 참고하세요.
Method: courses.courseWork.studentSubmissions.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
요청자의 OAuth 범위를 고려하여 요청자가 볼 수 있는 학생 제출물 목록을 반환합니다. -를 courseWorkId로 지정하여 여러 과정 과제 항목의 학생 제출물을 포함할 수 있습니다.
과정 학생은 자신의 과제물만 볼 수 있습니다. 강사와 도메인 관리자는 모든 학생의 제출물을 볼 수 있습니다.
이 메서드는 다음 오류 코드를 반환합니다.
- 요청하는 사용자가 요청된 과정 또는 과정 작업에 액세스할 수 없는 경우 또는 액세스 오류의 경우
PERMISSION_DENIED입니다.
INVALID_ARGUMENT: 요청 형식이 잘못된 경우- 요청된 과정이 없는 경우
NOT_FOUND입니다.
HTTP 요청
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
courseId |
string
과정의 식별자입니다. 이 식별자는 클래스룸에서 할당한 식별자 또는 alias일 수 있습니다.
|
courseWorkId |
string
요청할 학생 과제물의 식별자입니다. 지정된 과정의 모든 과정 과제에 대해 학생 과제를 요청하기 위해 문자열 리터럴 "-"로 설정할 수 있습니다.
|
쿼리 매개변수
| 매개변수 |
userId |
string
반환된 학생 과제물을 지정된 식별자가 있는 학생이 소유한 과제물로 제한하는 선택적 인수입니다. 식별자는 다음 중 하나일 수 있습니다.
- 사용자의 숫자 식별자
- 사용자의 이메일 주소
- 요청하는 사용자를 나타내는 문자열 리터럴
"me"
|
states[] |
enum (SubmissionState)
요청된 제출 상태 지정된 경우 반환된 학생 제출물이 지정된 제출 상태 중 하나와 일치합니다.
|
late |
enum (LateValues)
요청된 지연 시간 값입니다. 지정된 경우 반환된 학생 제출물은 요청된 값으로 제한됩니다. 지정하지 않으면 late 값과 관계없이 제출이 반환됩니다.
|
pageSize |
integer
반환할 최대 항목 수입니다. 0 또는 지정되지 않은 경우 서버에서 최대값을 할당할 수 있음을 나타냅니다. 서버에서 지정된 수보다 적은 결과를 반환할 수 있습니다.
|
pageToken |
string
이전 list 호출에서 반환된 nextPageToken 값으로, 후속 결과 페이지를 반환해야 함을 나타냅니다. list 요청은 이 토큰을 생성한 요청과 동일해야 합니다.
|
previewVersion |
enum (PreviewVersion)
선택사항입니다. API의 미리보기 버전입니다. 미리보기 프로그램에서 개발자에게 제공되는 새로운 API 기능에 액세스하려면 이 값을 설정해야 합니다.
|
응답 본문
학생 제출물을 나열할 때의 응답입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
| JSON 표현 |
{
"studentSubmissions": [
{
object (StudentSubmission)
}
],
"nextPageToken": string
} |
| 필드 |
studentSubmissions[] |
object (StudentSubmission)
요청과 일치하는 학생 과제물
|
nextPageToken |
string
반환할 다음 결과 페이지를 식별하는 토큰입니다. 비어 있으면 더 이상 결과를 사용할 수 없습니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
자세한 내용은 승인 가이드를 참고하세요.
LateValues
| 열거형 |
LATE_VALUES_UNSPECIFIED |
제출 지연 값에 대한 제한사항이 지정되지 않았습니다. |
LATE_ONLY |
late가 true인 StudentSubmissions를 반환합니다. |
NOT_LATE_ONLY |
late가 false인 StudentSubmissions를 반환합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 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.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListStudentSubmissionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [LateValues](#LateValues)\n- [Try it!](#try-it)\n\nReturns a list of student submissions that the requester is permitted to view, factoring in the OAuth scopes of the request. `-` may be specified as the `courseWorkId` to include student submissions for multiple course work items.\n\nCourse students may only view their own work. Course teachers and domain administrators may view all student submissions.\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, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions`\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 student work to request. This may be set to the string literal `\"-\"` to request student work for all course work in the specified course. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string` Optional argument to restrict returned student work to those owned by the student with the specified identifier. The identifier can be one of the following: - the numeric identifier for the user - the email address of the user - the string literal `\"me\"`, indicating the requesting user |\n| `states[]` | `enum (`[SubmissionState](/workspace/classroom/reference/rest/v1/SubmissionState)`)` Requested submission states. If specified, returned student submissions match one of the specified submission states. |\n| `late` | `enum (`[LateValues](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions/list#LateValues)`)` Requested lateness value. If specified, returned student submissions are restricted by the requested value. If unspecified, submissions are returned regardless of `late` value. |\n| `pageSize` | `integer` Maximum number of items to return. Zero or unspecified indicates that the server may assign a maximum. The server may return fewer than the specified number of results. |\n| `pageToken` | `string` [nextPageToken](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions/list#body.ListStudentSubmissionsResponse.FIELDS.next_page_token) value returned from a previous `list` call, indicating that the subsequent page of results should be returned. The `list` request must be otherwise identical to the one that resulted in this token. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse when listing student submissions.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"studentSubmissions\": [ { object (/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `studentSubmissions[]` | `object (`[StudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission)`)` Student work that matches the request. |\n| `nextPageToken` | `string` Token identifying the next page of results to return. If empty, no further results are available. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students.readonly`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me.readonly`\n- `\n https://www.googleapis.com/auth/classroom.coursework.students`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nLateValues\n----------\n\nRestrictions on the late value of returned items.\n\n| Enums ||\n|---------------------------|-----------------------------------------------------|\n| `LATE_VALUES_UNSPECIFIED` | No restriction on submission late values specified. |\n| `LATE_ONLY` | Return StudentSubmissions where late is true. |\n| `NOT_LATE_ONLY` | Return StudentSubmissions where late is false. |"]]
