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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
필드
courseId

string

수업의 식별자입니다.

읽기 전용입니다.
id

string

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

읽기 전용입니다.
title

string

이 수업 과제의 제목입니다. 제목은 1~3,000자(영문 기준)를 포함하는 유효한 UTF-8 문자열이어야 합니다.
description

string

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

object (Material)

추가 자료

학습 과제에는 자료 항목이 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

이 수업 과제 항목이 요청을 수행하는 개발자 콘솔 프로젝트와 연결되어 있는지 여부입니다.

자세한 내용은 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의 프리뷰 버전입니다.
learningGoals[]

object (LearningGoal)

선택사항입니다.

이 수업 과제에 연결된 학습 목표에 대한 참조입니다. 학습 과제에는 최대 10개의 학습 목표가 포함될 수 있습니다. 이 필드는 적절한 previewVersion가 설정된 경우에만 채워집니다.
수업 과제 유형에 관한 추가 세부정보입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
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 제출물은 언제든지 수정할 수 있습니다.

할당

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

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

object (DriveFolder)

학생 제출물의 첨부파일이 저장되는 Drive 폴더입니다. 강의 교사와 관리자에게만 채워집니다.

MultipleChoiceQuestion

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

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

string

가능한 선택지입니다.

메서드

create

 수업 과제를 만듭니다.

delete

 과제물을 삭제합니다.

get

 과제물을 반환합니다.

getAddOnContext

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

list

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

modifyAssignees

 학습 과제의 담당자 모드 및 옵션을 수정합니다.

patch

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