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 지각이 true인 StudentSubmission을 반환합니다.
NOT_LATE_ONLY 지각이 false인 StudentSubmission을 반환합니다.