REST Resource: courses

{
  "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)
  }
}

string

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

creating a course인 경우 선택적으로 요청에서 이 식별자를 alias string로 설정하여 상응하는 별칭을 만들 수 있습니다. id는 여전히 클래스룸에서 할당하며 과정을 만든 후에는 업데이트할 수 없습니다.

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

string

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

string

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

string

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

string

설명(선택사항) 예: "교과서, 초청 강연, 실험실 활동을 통해 생물의 구조를 알아보고자 합니다. 기대하세요!" 이 필드는 설정된 경우 유효한 UTF-8 문자열이어야 하며 30,000자(영문 기준) 이하여야 합니다.

string

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

string

과정 소유자의 식별자입니다.

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

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

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

string (Timestamp format)

과정의 생성 시간입니다. 과정 업데이트 마스크에 이 필드를 지정하면 오류가 발생합니다.

읽기 전용입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

string (Timestamp format)

이 과정이 마지막으로 업데이트된 시간입니다. 과정 업데이트 마스크에 이 필드를 지정하면 오류가 발생합니다.

읽기 전용입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

string

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

읽기 전용입니다.

enum (CourseState)

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

string

클래스룸 웹 UI에서 이 과정으로 연결되는 절대 링크입니다.

읽기 전용입니다.

string

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

읽기 전용입니다.

string

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

읽기 전용입니다.

object (DriveFolder)

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

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

읽기 전용입니다.

object (CourseMaterialSet)

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

읽기 전용입니다.

boolean

이 과정의 보호자 알림 사용 설정 여부입니다.

읽기 전용입니다.

string

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

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

읽기 전용입니다.

object (GradebookSettings)

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

읽기 전용

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

이 세트의 제목입니다.

object (CourseMaterial)

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

{

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

object (DriveFile)

Google Drive 파일 첨부

object (YouTubeVideo)

YouTube 동영상 첨부파일

object (Link)

링크 첨부파일

object (Form)

Google Forms 첨부파일.

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

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

enum (DisplaySetting)

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

object (GradeCategory)

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