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)

이 과정 과제가 생성된 타임스탬프입니다.

읽기 전용입니다.

생성된 출력은 항상 Z-정규화되고 소수점 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

이 과정 작업이 마지막으로 변경된 시점의 타임스탬프입니다.

읽기 전용입니다.

생성된 출력은 항상 Z-정규화되고 소수점 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
dueDate

object (Date)

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

object (TimeOfDay)

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

string (Timestamp format)

이 수업 과제가 게시될 예정인 타임스탬프(선택사항)입니다.

생성된 출력은 항상 Z-정규화되고 소수점 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
maxPoints

number

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

enum (CourseWorkType)

이 수업 과제의 유형입니다.

유형은 과정 작업을 만들 때 설정되며 변경할 수 없습니다.
associatedWithDeveloper

boolean

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

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

읽기 전용입니다.
assigneeMode

enum (AssigneeMode)

강의의 담당자 모드입니다. 지정하지 않으면 기본값은 ALL_STUDENTS입니다.
individualStudentsOptions

object (IndividualStudentsOptions)

과정 자료에 액세스할 수 있는 학생의 식별자입니다. 이 필드는 assigneeMode이 INDIVIDUAL_STUDENTS인 경우에만 설정됩니다. assigneeMode가 INDIVIDUAL_STUDENTS이면 이 필드에 지정된 학생에게만 강의 과정이 할당됩니다.
submissionModificationMode

enum (SubmissionModificationMode)

학생이 제출물을 수정할 수 있는 시기를 결정하는 설정입니다. 지정하지 않으면 기본값은 MODIFIABLE_UNTIL_TURNED_IN입니다.
creatorUserId

string

강의 자료를 만든 사용자의 식별자입니다.

읽기 전용입니다.
topicId

string

이 과정이 연결된 주제의 식별자입니다. 과정의 기존 주제와 일치해야 합니다.
gradeCategory

object (GradeCategory)

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

읽기 전용입니다.
previewVersion

enum (PreviewVersion)

출력 전용입니다. 이 리소스를 검색하는 데 사용되는 API의 미리보기 버전입니다.
통합 필드 details. 과정 작업 유형에 관한 추가 세부정보입니다. details은 다음 중 하나여야 합니다.
assignment

object (Assignment)

과제 세부정보 workType가 ASSIGNMENT일 때만 채워집니다.

읽기 전용입니다.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

객관식 질문 세부정보 읽기 작업의 경우 이 필드는 workType가 MULTIPLE_CHOICE_QUESTION인 경우에만 채워집니다. 쓰기 작업의 경우 이 필드는 workType이 MULTIPLE_CHOICE_QUESTION인 과정 작업을 만들 때 지정해야 하며 그 외의 경우에는 설정하면 안 됩니다.
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 제출물은 언제든지 수정할 수 있습니다.

Assignment

과제에 대한 추가 세부정보입니다.

JSON 표현 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
필드
studentWorkFolder

object (DriveFolder)

학생 제출물의 첨부파일이 저장되는 Drive 폴더입니다. 이 필드는 과정 교사 및 관리자에게만 입력됩니다.

MultipleChoiceQuestion

객관식 질문에 대한 추가 세부정보

JSON 표현 
{
  "choices": [
    string
  ]
}
필드
choices[]

string

가능한 선택사항

메서드

create

 수업 과제를 만듭니다.

delete

 과정 작업을 삭제합니다.

get

 과정 과제를 반환합니다.

getAddOnContext

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

list

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

modifyAssignees

 강의의 담당자 모드 및 옵션을 수정합니다.

patch

 과정 작업의 필드 하나 이상을 업데이트합니다.