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

Giá trị nhận dạng cho khoá học do Lớp học chỉ định này.

Khi creating a course, bạn có thể tuỳ ý đặt giá trị nhận dạng này thành alias string trong yêu cầu tạo bí danh tương ứng. id vẫn do Lớp học chỉ định nên bạn không thể cập nhật sau khi tạo khoá học.

Việc chỉ định trường này trong mặt nạ cập nhật khoá học sẽ dẫn đến lỗi.

string

Tên khoá học. Ví dụ: "Sinh học lớp 10". Bạn phải nhập tên. Mã này phải có từ 1 đến 750 ký tự và là một chuỗi UTF-8 hợp lệ.

string

Phần của khoá học. Ví dụ: "Khoảng thời gian 2". Nếu được đặt, trường này phải là một chuỗi UTF-8 hợp lệ và không được dài quá 2.800 ký tự.

string

Tiêu đề không bắt buộc cho nội dung mô tả. Ví dụ: "Chào mừng bạn đến với Sinh học lớp 10". Nếu được đặt, trường này phải là một chuỗi UTF-8 hợp lệ và không được dài quá 3.600 ký tự.

string

Nội dung mô tả không bắt buộc. Ví dụ: "Chúng ta sẽ tìm hiểu về cấu trúc của các sinh vật sống thông qua sách giáo khoa, bài giảng của khách mời và hoạt động trong phòng thí nghiệm. Chắc chắn là sẽ hào hứng!" Nếu được đặt, trường này phải là một chuỗi UTF-8 hợp lệ và không được dài quá 30.000 ký tự.

string

Vị trí phòng (không bắt buộc). Ví dụ: "301". Nếu được đặt, trường này phải là một chuỗi UTF-8 hợp lệ và không được dài quá 650 ký tự.

string

Giá trị nhận dạng của chủ sở hữu khoá học.

Khi được chỉ định làm tham số của create course request, trường này là bắt buộc. Giá trị nhận dạng có thể là một trong những giá trị sau:

• giá trị nhận dạng dưới dạng số cho người dùng
• địa chỉ email của người dùng
• giá trị cố định kiểu chuỗi "me", cho biết người dùng đưa ra yêu cầu

Bạn phải đặt giá trị này trong yêu cầu tạo. Quản trị viên cũng có thể chỉ định trường này trong patch course request để chuyển quyền sở hữu. Trong các trường hợp khác, chế độ này ở chế độ chỉ đọc.

string (Timestamp format)

Thời gian tạo khoá học. Việc chỉ định trường này trong mặt nạ cập nhật khoá học sẽ dẫn đến lỗi.

Chỉ có thể đọc.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Thời gian của lần cập nhật gần đây nhất đối với khoá học này. Việc chỉ định trường này trong mặt nạ cập nhật khoá học sẽ dẫn đến lỗi.

Chỉ có thể đọc.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string

Mã đăng ký để sử dụng khi tham gia khoá học này. Việc chỉ định trường này trong mặt nạ cập nhật khoá học sẽ dẫn đến lỗi.

Chỉ có thể đọc.

enum (CourseState)

Trạng thái của khoá học. Nếu bạn không chỉ định, trạng thái mặc định sẽ là PROVISIONED.

string

Đường liên kết tuyệt đối đến khoá học này trong giao diện người dùng web của Lớp học.

Chỉ có thể đọc.

string

Địa chỉ email của một nhóm trên Google Groups chứa tất cả giáo viên của khoá học. Nhóm này không chấp nhận email và chỉ có thể dùng để cấp quyền.

Chỉ có thể đọc.

string

Địa chỉ email của một nhóm trên Google Groups có tất cả thành viên của khoá học. Nhóm này không chấp nhận email và chỉ có thể dùng để cấp quyền.

Chỉ có thể đọc.

object (DriveFolder)

Thông tin về một Thư mục trên Drive được chia sẻ với tất cả giáo viên của khoá học.

Trường này sẽ chỉ được thiết lập cho giáo viên của khoá học và quản trị viên miền.

Chỉ có thể đọc.

object (CourseMaterialSet)

Bộ tài liệu xuất hiện trên trang "giới thiệu" của khoá học này.

Chỉ có thể đọc.

boolean

Liệu thông báo dành cho người giám hộ có được bật cho khoá học này hay không.

Chỉ có thể đọc.

string

Mã lịch của lịch mà tất cả thành viên trong khoá học đều có thể thấy. Lớp học sẽ thêm các sự kiện liên quan đến bài tập trong khoá học và thông báo trong khoá học.

Lịch cho một khoá học được tạo không đồng bộ trong lần đầu tiên đặt khoá học thành CourseState.ACTIVE (tại thời điểm tạo hoặc khi được cập nhật lên ACTIVE thông qua giao diện người dùng hoặc API). Mã lịch sẽ không được điền cho đến khi quá trình tạo hoàn tất.

Chỉ có thể đọc.

object (GradebookSettings)

Chế độ cài đặt sổ điểm chỉ định cách tính tổng điểm của học viên trong khoá học và cho đối tượng xem điểm.

Chỉ có thể đọc

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

string

Tiêu đề cho loạt video này.

object (CourseMaterial)

Tài liệu đính kèm với tập hợp này.

{

  // 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)

Tệp đính kèm trên Google Drive.

object (YouTubeVideo)

Tệp đính kèm video trên YouTube.

object (Link)

Tùy chọn liên kết.

object (Form)

Tệp đính kèm trên Google Biểu mẫu.

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

enum (CalculationType)

Cho biết cách tính tổng điểm.

enum (DisplaySetting)

Cho biết ai có thể xem tổng điểm..

object (GradeCategory)

Danh mục điểm có sẵn cho bài tập trong khoá học.