요청의 OAuth 범위를 고려하여 요청자가 볼 수 있는 학생 제출물 목록을 반환합니다. -
를 courseWorkId
로 지정하여 여러 수업 과제 항목의 학생 제출물을 포함할 수 있습니다.
강의 학생은 자신의 과제물만 볼 수 있습니다. 과정 교사와 도메인 관리자는 모든 학생 제출물을 볼 수 있습니다.
이 메서드는 다음 오류 코드를 반환합니다.
PERMISSION_DENIED
: 요청하는 사용자가 요청한 강의 또는 수업 과제에 액세스할 수 없거나 액세스 오류가 있는 경우INVALID_ARGUMENT
: 요청 형식이 잘못된 경우NOT_FOUND
: 요청된 과정이 존재하지 않는 경우
HTTP 요청
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
courseId |
과정의 식별자입니다. 이 식별자는 클래스룸에서 할당한 식별자 또는 |
courseWorkId |
요청할 학생 과제물의 식별자입니다. 문자열 리터럴 |
쿼리 매개변수
매개변수 | |
---|---|
userId |
반환되는 학생 과제물을 지정된 식별자를 가진 학생이 소유한 과제물로 제한하는 선택적 인수입니다. 식별자는 다음 중 하나일 수 있습니다.
|
states[] |
요청한 제출 상태입니다. 지정하면 반환된 학생 제출물이 지정된 제출 상태 중 하나와 일치합니다. |
late |
요청된 지연 값입니다. 지정된 경우 반환되는 학생 제출물은 요청된 값으로 제한됩니다. 지정하지 않으면 |
pageSize |
반환할 최대 항목 수입니다. 0 또는 지정되지 않은 경우 서버가 최댓값을 할당할 수 있음을 나타냅니다. 서버가 지정된 수보다 적은 수의 결과를 반환할 수 있습니다. |
pageToken |
이전 그 외에 |
previewVersion |
선택사항입니다. API의 미리보기 버전입니다. 미리보기 프로그램에서 개발자에게 제공되는 새로운 API 기능에 액세스하려면 이를 설정해야 합니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
학생 제출물을 나열할 때의 응답
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"studentSubmissions": [
{
object ( |
필드 | |
---|---|
studentSubmissions[] |
요청과 일치하는 학생 과제물입니다. |
nextPageToken |
반환할 결과의 다음 페이지를 식별하는 토큰입니다. 비어 있으면 더 이상 결과를 사용할 수 없습니다. |
승인 범위
다음 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를 반환합니다. |