REST Resource: courses

리소스: Course

클래스룸의 수업

JSON 표현 
{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}
필드
id

string

클래스룸에서 할당한 이 수업의 식별자입니다.

creating a course인 경우 요청에서 이 식별자를 alias string로 설정하여 해당 별칭을 만들 수 있습니다. id는 여전히 클래스룸에서 할당하며, 수업이 생성된 후에는 업데이트할 수 없습니다.

과정 업데이트 마스크에서 이 필드를 지정하면 오류가 발생합니다.
name

string

수업 이름입니다. 예: '10학년 생물학' 이름은 필수 항목입니다. 1~750자(영문 기준) 사이여야 하며 유효한 UTF-8 문자열이어야 합니다.
section

string

과정의 섹션입니다. 예: '2교시' 설정된 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 2, 800자(영문 기준) 이하여야 합니다.
descriptionHeading

string

설명의 선택적 제목입니다. 예: '10학년 생물에 오신 것을 환영합니다.' 설정된 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 3, 600자(영문 기준) 이하여야 합니다.
description

string

설명(선택사항) 예를 들어 '교과서, 초청 강연, 실험실 작업을 통해 생물의 구조에 대해 배우게 됩니다. 기대하셔도 좋습니다!' 설정된 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 30,000자(영문 기준) 이하여야 합니다.
room

string

선택적 회의실 위치입니다. 예: '301' 설정된 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 650자(영문 기준) 이하여야 합니다.
ownerId

string

수업 소유자의 식별자입니다.

create course request의 매개변수로 지정된 경우 이 필드는 필수입니다. 식별자는 다음 중 하나일 수 있습니다.

  • 사용자의 숫자 식별자
  • 사용자의 이메일 주소
  • 요청하는 사용자를 나타내는 문자열 리터럴 "me"

생성 요청에서 설정해야 합니다. 관리자는 patch course request에서 이 필드를 지정하여 소유권을 이전할 수도 있습니다. 다른 컨텍스트에서는 읽기 전용입니다.
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"입니다.
enrollmentCode

string

이 과정에 참여할 때 사용할 등록 코드입니다. 과정 업데이트 마스크에서 이 필드를 지정하면 오류가 발생합니다.

읽기 전용입니다.
courseState

enum (CourseState)

강의 상태입니다. 지정하지 않으면 기본 상태는 PROVISIONED입니다.
teacherGroupEmail

string

수업의 모든 교사가 포함된 Google 그룹의 이메일 주소입니다. 이 그룹은 이메일을 수락하지 않으며 권한에만 사용할 수 있습니다.

읽기 전용입니다.
courseGroupEmail

string

수업의 모든 회원이 포함된 Google 그룹의 이메일 주소입니다. 이 그룹은 이메일을 수락하지 않으며 권한에만 사용할 수 있습니다.

읽기 전용입니다.
teacherFolder

object (DriveFolder)

수업의 모든 교사와 공유되는 Drive 폴더에 관한 정보입니다.

이 필드는 과정의 교사와 도메인 관리자에게만 설정됩니다.

읽기 전용입니다.
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

이 과정의 '정보' 페이지에 표시되는 자료 집합입니다.

읽기 전용입니다.
guardiansEnabled

boolean

이 과정에 보호자 알림이 사용 설정되어 있는지 여부입니다.

읽기 전용입니다.
calendarId

string

모든 수업 구성원이 볼 수 있는 캘린더의 캘린더 ID입니다. 클래스룸은 이 캘린더에 수업 과제 및 수업 공지사항의 일정을 추가합니다.

강의의 캘린더는 강의가 처음으로 CourseState.ACTIVE로 설정될 때 (생성 시 또는 UI나 API를 통해 ACTIVE로 업데이트될 때) 비동기적으로 생성됩니다. 생성 프로세스가 완료될 때까지 Calendar ID가 채워지지 않습니다.

읽기 전용입니다.
gradebookSettings

object (GradebookSettings)

학생의 과정 전체 성적을 계산하는 방법과 성적을 표시할 대상을 지정하는 성적장부 설정입니다.

읽기 전용

CourseState

강의가 가질 수 있는 상태입니다.

열거형
COURSE_STATE_UNSPECIFIED 과정 상태가 없습니다. 반환된 과정 메시지는 이 값을 사용하지 않습니다.
ACTIVE 강의가 활성 상태입니다.
ARCHIVED 수업이 보관처리되었습니다. 다른 상태로 변경하는 경우를 제외하고는 수정할 수 없습니다.
PROVISIONED 과정이 생성되었지만 아직 활성화되지 않았습니다. 기본 교사와 도메인 관리자가 액세스할 수 있으며, 이들은 이를 수정하거나 ACTIVE 또는 DECLINED 상태로 변경할 수 있습니다. 과정은 DECLINED 상태인 경우에만 PROVISIONED로 변경할 수 있습니다.
DECLINED 과정이 생성되었지만 거부되었습니다. 웹 UI에는 표시되지 않지만 과정 소유자와 도메인 관리자가 액세스할 수 있습니다. PROVISIONED 상태로 변경하는 경우를 제외하고는 과정을 수정할 수 없습니다. 과정은 PROVISIONED 상태인 경우에만 DECLINED로 변경할 수 있습니다.
SUSPENDED 과정이 정지되었습니다. 과정을 수정할 수 없으며 ownerId로 식별된 사용자만 과정을 볼 수 있습니다. 서비스 약관을 위반할 가능성이 있는 경우 강의가 이 상태로 전환될 수 있습니다.

CourseMaterialSet

강의의 '정보' 페이지에 표시되는 자료 세트입니다. 이러한 자료에는 강의 전체와 관련된 강의 계획서, 일정 또는 기타 배경 정보가 포함될 수 있습니다.

JSON 표현 
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
필드
title

string

이 세트의 제목입니다.
materials[]

object (CourseMaterial)

이 세트에 첨부된 자료입니다.

CourseMaterial

자료 세트의 일부로 강의에 첨부된 자료입니다.

JSON 표현 
{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}
필드
통합 필드 material. 재료 데이터입니다. material은 다음 중 하나여야 합니다.
driveFile

object (DriveFile)

Google Drive 파일 첨부
youTubeVideo

object (YouTubeVideo)

YouTube 동영상 첨부파일
form

object (Form)

Google Forms 첨부파일입니다.

GradebookSettings

수업의 성적장부 설정입니다. 자세한 내용은 고객센터 도움말을 참고하세요.

JSON 표현 
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
필드
calculationType

enum (CalculationType)

전체 성적이 계산되는 방식을 나타냅니다.
displaySetting

enum (DisplaySetting)

전체 성적을 볼 수 있는 사용자를 나타냅니다.
gradeCategories[]

object (GradeCategory)

수업에서 사용할 수 있는 성적 카테고리입니다.

CalculationType

전체 성적 계산의 가능한 방법입니다.

열거형
CALCULATION_TYPE_UNSPECIFIED 지정된 메서드가 없습니다. 이 값은 반환되지 않습니다.
TOTAL_POINTS 전체 성적은 카테고리와 관계없이 성적의 합계를 총점의 합계로 나눈 값입니다.
WEIGHTED_CATEGORIES 전체 성적은 카테고리별 가중 평균입니다.

DisplaySetting

전체 성적을 표시하기 위한 가능한 설정입니다.

열거형
DISPLAY_SETTING_UNSPECIFIED 지정된 설정이 없습니다. 이 값은 반환되지 않습니다.
SHOW_OVERALL_GRADE 성적부와 학생 프로필에 교사와 학생 모두에게 전체 성적을 표시합니다.
HIDE_OVERALL_GRADE 성적 기록 또는 학생 프로필에 전체 성적이 표시되지 않습니다.
SHOW_TEACHERS_ONLY 성적장부 및 학생 프로필에 교사에게 전체 성적을 표시합니다. 학생 프로필에서 학생에게 숨겨집니다.

메서드

checkAddOnCreationEligibility
(deprecated)

 사용자가 지정된 과정에서 부가기능 첨부파일을 만들 수 있는지 여부를 반환합니다.

checkGradingPeriodsSetupEligibility
(deprecated)

 사용자가 지정된 수업에서 GradingPeriodSettings를 업데이트할 수 있는지 여부를 반환합니다.

create

 강의를 만듭니다.

delete

 강의를 삭제합니다.

get

 과정을 반환합니다.

getGradingPeriodSettings

 강의의 평가 기간 설정을 반환합니다.

list

 요청하는 사용자가 볼 수 있는 과정 목록을 반환합니다. 요청과 일치하는 과정으로 제한됩니다.

patch

 강의에서 하나 이상의 필드를 업데이트합니다.

update

 강의를 업데이트합니다.

updateGradingPeriodSettings

 수업의 평가 기간 설정을 업데이트합니다.