- 리소스: 과정
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- 메서드
리소스: 과정
클래스룸 과정
JSON 표현 |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
필드 | |
---|---|
id |
클래스룸에서 할당한 이 과정의 식별자입니다.
과정 업데이트 마스크에서 이 필드를 지정하면 오류가 발생합니다. |
name |
수업의 이름입니다. 예: '10학년 생물학' 이름은 필수 항목입니다. 1~750자(영문 기준)여야 하며 유효한 UTF-8 문자열을 사용해야 합니다. |
section |
과정의 섹션입니다. 예: '기간 2' 설정하는 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 2, 800자(영문 기준) 이하여야 합니다. |
descriptionHeading |
설명의 제목(선택사항)입니다. 예: '10학년 생물학에 오신 것을 환영합니다.' 설정하는 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 3, 600자(영문 기준) 이하여야 합니다. |
description |
설명(선택사항)입니다. 예: "교과서, 초청 강의, 실험실 작업을 통해 생물의 구조에 대해 배워보겠습니다. 기대해 주세요!" 설정된 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 30,000자(영문 기준) 이하여야 합니다. |
room |
회의실 위치입니다(선택사항). 예: '301' 설정하는 경우 이 필드는 유효한 UTF-8 문자열이어야 하며 650자(영문 기준) 이하여야 합니다. |
ownerId |
강의 소유자의 식별자입니다.
만들기 요청에서 설정해야 합니다. 관리자는 |
creationTime |
과정의 생성 시간입니다. 과정 업데이트 마스크에서 이 필드를 지정하면 오류가 발생합니다. 읽기 전용입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
updateTime |
이 과정이 가장 최근에 업데이트된 시간입니다. 과정 업데이트 마스크에서 이 필드를 지정하면 오류가 발생합니다. 읽기 전용입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
enrollmentCode |
이 과정에 참여할 때 사용할 등록 코드입니다. 과정 업데이트 마스크에서 이 필드를 지정하면 오류가 발생합니다. 읽기 전용입니다. |
courseState |
과정의 상태입니다. 지정하지 않으면 기본 상태는 |
alternateLink |
클래스룸 웹 UI 내 이 과정으로 연결되는 절대 링크입니다. 읽기 전용입니다. |
teacherGroupEmail |
과정의 모든 교사가 포함된 Google 그룹의 이메일 주소입니다. 이 그룹은 이메일을 수락하지 않으며 권한이 있는 경우에만 사용할 수 있습니다. 읽기 전용입니다. |
courseGroupEmail |
과정의 모든 회원이 포함된 Google 그룹의 이메일 주소입니다. 이 그룹은 이메일을 수락하지 않으며 권한이 있는 경우에만 사용할 수 있습니다. 읽기 전용입니다. |
teacherFolder |
이 과정의 모든 교사와 공유되는 Drive 폴더에 관한 정보입니다. 이 입력란은 과정의 교사와 도메인 관리자에게만 설정됩니다. 읽기 전용입니다. |
courseMaterialSets[] |
이 과정의 '소개' 페이지에 표시되는 자료 모음입니다. 읽기 전용입니다. |
guardiansEnabled |
이 강의에서 보호자 알림을 사용 설정했는지 여부입니다. 읽기 전용입니다. |
calendarId |
모든 수업 회원이 볼 수 있는 캘린더의 캘린더 ID로, 클래스룸에서 수업 활동 및 공지사항에 대한 일정을 추가합니다. 강의가 처음 읽기 전용입니다. |
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 ( |
필드 | |
---|---|
title |
이 세트의 제목입니다. |
materials[] |
이 세트에 연결된 자료입니다. |
CourseMaterial
자료 세트의 일부로 과정에 첨부된 자료입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 material . Material 데이터 material 은 다음 중 하나여야 합니다. |
|
driveFile |
Google Drive 첨부파일 |
youTubeVideo |
YouTube 동영상 첨부파일 |
link |
링크 연결. |
form |
Google Forms 첨부파일입니다. |
GradebookSettings
수업의 성적 기록 설정입니다. 자세한 내용은 고객센터 도움말을 참고하세요.
JSON 표현 |
---|
{ "calculationType": enum ( |
필드 | |
---|---|
calculationType |
전체 성적이 계산되는 방식을 나타냅니다. |
displaySetting |
전체 성적을 볼 수 있는 사용자를 나타냅니다. |
gradeCategories[] |
수업의 학습 과제에 사용할 수 있는 성적 카테고리입니다. |
CalculationType
가능한 전체 성적 계산 방법입니다.
열거형 | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
지정된 방법이 없습니다. 반환되지 않습니다. |
TOTAL_POINTS |
전체 성적은 카테고리와 관계없이 성적의 합계를 총점의 합계로 나눈 값입니다. |
WEIGHTED_CATEGORIES |
전체 성적은 카테고리별 가중치가 적용된 평균입니다. |
DisplaySetting
전체 성적을 표시하기 위해 사용할 수 있는 설정입니다.
열거형 | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
지정된 설정이 없습니다. 반환되지 않습니다. |
SHOW_OVERALL_GRADE |
성적 기록과 학생 프로필의 전체 성적을 교사와 학생 모두에게 표시합니다. |
HIDE_OVERALL_GRADE |
성적 기록 또는 학생 프로필의 전체 성적은 표시되지 않습니다. |
SHOW_TEACHERS_ONLY |
성적 기록 및 학생 프로필에서 교사에게 전체 성적을 표시합니다. 학생 프로필에서 학생에게 표시되지 않습니다. |
방법 |
|
---|---|
|
사용자가 지정된 강의에서 부가기능 첨부파일을 만들 수 있는지 여부를 반환합니다. |
|
과정을 만듭니다. |
|
강의를 삭제합니다. |
|
강의를 반환합니다. |
|
요청하는 사용자가 볼 수 있도록 허용된 과정 중 요청과 일치하는 과정으로 제한된 과정의 목록을 반환합니다. |
|
수업에서 하나 이상의 필드를 업데이트합니다. |
|
과정을 업데이트합니다. |