REST Resource: courses.courseWork

리소스: CourseWork

교사가 수업의 학생을 위해 만든 수업 과제입니다.

JSON 표현
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
입력란
courseId

string

과정의 식별자입니다.

읽기 전용입니다.

id

string

클래스룸에서 할당한 이 수업 과제의 식별자로, 강의별로 고유합니다.

읽기 전용입니다.

title

string

이 과정의 제목입니다. 제목은 1~3,000자(영문 기준)의 유효한 UTF-8 문자열이어야 합니다.

description

string

이 과정의 결과물에 대한 설명입니다(선택사항). 설정하는 경우 설명은 30,000자 이하의 유효한 UTF-8 문자열이어야 합니다.

materials[]

object (Material)

추가 자료.

CourseWork에는 20개 이하의 자료 항목이 있어야 합니다.

state

enum (CourseWorkState)

이 학습 과정의 상태입니다. 지정되지 않은 경우 기본 상태는 DRAFT입니다.

creationTime

string (Timestamp format)

이 과정 작업이 생성된 타임스탬프입니다.

읽기 전용입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

이 학습과정 활동의 가장 최근 변경사항의 타임스탬프입니다.

읽기 전용입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

dueDate

object (Date)

이 과정 과제의 제출 마감일(UTC 기준)입니다(선택사항). dueTime이 지정된 경우 지정해야 합니다.

dueTime

object (TimeOfDay)

이 과정 과제의 제출 마감 시간(UTC 기준)입니다(선택사항). dueDate이 지정된 경우 지정해야 합니다.

scheduledTime

string (Timestamp format)

이 과정 과제가 게시되도록 예약된 시점의 타임스탬프입니다(선택사항).

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

maxPoints

number

이 학습과정 활동의 최고 성적입니다. 0이거나 지정되지 않은 경우 이 과제는 미채점으로 간주됩니다. 음이 아닌 정수 값이어야 합니다.

workType

enum (CourseWorkType)

이 과정의 유형입니다.

유형은 수업 과제 생성 시 설정되며 변경할 수 없습니다.

associatedWithDeveloper

boolean

이 과정 작업 항목이 요청하는 Play Console 프로젝트와 연결되어 있는지 여부입니다.

자세한 내용은 courseWork.create를 참고하세요.

읽기 전용입니다.

assigneeMode

enum (AssigneeMode)

수업 과제의 담당자 모드입니다. 지정되지 않은 경우 기본값은 ALL_STUDENTS입니다.

individualStudentsOptions

object (IndividualStudentsOptions)

수업 과제에 액세스할 수 있는 학생의 식별자입니다. 이 필드는 assigneeModeINDIVIDUAL_STUDENTS인 경우에만 설정됩니다. assigneeModeINDIVIDUAL_STUDENTS이면 이 필드에 지정된 학생만 수업 과제가 할당됩니다.

submissionModificationMode

enum (SubmissionModificationMode)

학생이 제출물을 수정할 수 있는 경우를 결정하는 설정 지정되지 않은 경우 기본값은 MODIFIABLE_UNTIL_TURNED_IN입니다.

creatorUserId

string

학습 과제를 만든 사용자의 식별자입니다.

읽기 전용입니다.

topicId

string

이 학습 프로그램과 연결된 주제의 식별자입니다. 과정의 기존 주제와 일치해야 합니다.

gradeCategory

object (GradeCategory)

이 수업 과제의 성적이 기여하는 카테고리입니다. 수업 과제의 카테고리가 선택된 경우에만 표시됩니다. 전체 성적을 계산하는 데 사용할 수 있습니다.

읽기 전용입니다.

previewVersion

enum (PreviewVersion)

출력 전용입니다. 이 리소스를 검색하는 데 사용되는 API의 미리보기 버전입니다.

통합 필드 details. 수업 과제 유형과 관련된 추가 세부정보입니다. details는 다음 중 하나여야 합니다.
assignment

object (Assignment)

과제 세부정보 workTypeASSIGNMENT인 경우에만 채워집니다.

읽기 전용입니다.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

객관식 질문 세부정보입니다. 읽기 작업의 경우 이 필드는 workTypeMULTIPLE_CHOICE_QUESTION인 경우에만 채워집니다. 쓰기 작업의 경우 이 필드는 MULTIPLE_CHOICE_QUESTIONworkType로 학습 과정을 만들 때 지정해야 하며, 달리 설정해서는 안 됩니다.

gradingPeriodId

string

학습 과제와 관련된 평가 기간의 식별자입니다.

  • 지정하지 않으면 평가 기간 ID가 dueDate를 기준으로 설정됩니다 (dueDate가 설정되지 않은 경우 scheduledTime).
  • 평가 기간과 관련이 없음을 나타내려면 이 필드를 빈 문자열 ("")으로 설정하세요.
  • 지정된 경우 강의의 기존 평가 기간 ID와 일치해야 합니다.

CourseWorkState

작업의 가능한 상태입니다.

열거형
COURSE_WORK_STATE_UNSPECIFIED 지정된 상태가 없습니다. 이 값은 반환되지 않습니다.
PUBLISHED 게시된 저작물의 상태입니다. 이는 기본 상태입니다.
DRAFT 아직 게시되지 않은 저작물의 상태입니다. 이 상태의 작업은 수업 교사와 도메인 관리자에게만 표시됩니다.
DELETED 게시되었지만 현재 삭제된 작업의 상태입니다. 이 상태의 작업은 수업 교사와 도메인 관리자에게만 표시됩니다. 이 상태의 작업은 일정 시간이 지난 후 삭제됩니다.

SubmissionModificationMode

학생 제출물에 가능한 수정 모드

열거형
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED 수정 모드가 지정되지 않았습니다. 이 값은 반환되지 않습니다.
MODIFIABLE_UNTIL_TURNED_IN 제출물은 제출하기 전에 수정할 수 있습니다.
MODIFIABLE 제출물은 언제든지 수정할 수 있습니다.

임무

할당에 대한 추가 세부정보입니다.

JSON 표현
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
입력란
studentWorkFolder

object (DriveFolder)

학생 제출물의 첨부파일이 저장되는 Drive 폴더입니다. 이 필드는 과정 교사와 관리자에 대해서만 채워집니다.

MultipleChoiceQuestion

객관식 질문에 대한 추가 세부정보입니다.

JSON 표현
{
  "choices": [
    string
  ]
}
입력란
choices[]

string

가능한 선택사항.

방법

create

수업 과제를 만듭니다.

delete

수업 과제를 삭제합니다.

get

수업 과제를 반환합니다.

getAddOnContext

특정 게시물의 컨텍스트에서 클래스룸 부가기능의 메타데이터를 가져옵니다.

list

요청자가 볼 수 있는 수업 과제 목록을 반환합니다.

modifyAssignees

할당된 사용자 모드 및 수업 과제 옵션을 수정합니다.

patch

수업 과제의 필드를 하나 이상 업데이트합니다.