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

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

string

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

string

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

string

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

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)

과정의 모든 교사와 공유되는 드라이브 폴더에 관한 정보입니다.

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

읽기 전용입니다.

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)

코스에서 학습 활동에 사용할 수 있는 카테고리입니다.