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

수업별로 고유한 이 수업 과제의 Classroom 할당 식별자입니다.

읽기 전용입니다.
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의 미리보기 버전입니다.
통합 필드 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 제출물은 언제든지 수정할 수 있습니다.

할당

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

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

object (DriveFolder)

학생 제출의 첨부파일이 배치되는 Drive 폴더입니다. 이 필드는 과정 교사와 관리자에게만 채워집니다.

MultipleChoiceQuestion

객관식 질문의 추가 세부정보입니다.

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

string

가능한 선택사항입니다.

메서드

create

 수업 과제를 만듭니다.

delete

 과제를 삭제합니다.

get

 수업 과제를 반환합니다.

getAddOnContext

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

list

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

modifyAssignees

 과제물의 할당 대상 모드와 옵션을 수정합니다.

patch

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