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)
  },

  // 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.
}
필드
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

이 과정 작업 항목이 요청을 보내는 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)

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

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

object (Assignment)

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

읽기 전용입니다.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

객관식 질문 세부정보입니다. 읽기 작업의 경우 이 필드는 workType가 MULTIPLE_CHOICE_QUESTION인 경우에만 채워집니다. 쓰기 작업의 경우 workType가 MULTIPLE_CHOICE_QUESTION인 강의 과제를 만들 때 이 필드를 지정해야 하며, 달리 설정하면 안 됩니다.

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

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