- Tài nguyên: Khoá học
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- Phương thức
Tài nguyên: Khoá học
Khoá học trong Lớp học.
Biểu diễn dưới dạng JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Các trường | |
---|---|
id |
Mã nhận dạng của khoá học này do Lớp học chỉ định. Khi 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. |
name |
Tên của khoá học. Ví dụ: "Sinh học lớp 10". Bạn phải nhập tên. Mã này phải dài từ 1 đến 750 ký tự và phải là một chuỗi UTF-8 hợp lệ. |
section |
Một phần của khoá học. Ví dụ: "Kỳ 2". Nếu được đặt, trường này phải là một chuỗi UTF-8 hợp lệ và không dài quá 2800 ký tự. |
descriptionHeading |
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 môn 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 dài quá 3600 ký tự. |
description |
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 sinh vật sống nhờ sự kết hợp giữa sách giáo khoa, bài giảng của khách và bài tập trong phòng thí nghiệm. Hy vọng rằng bạn sẽ rất 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 dài quá 30.000 ký tự. |
room |
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 dài quá 650 ký tự. |
ownerId |
Giá trị nhận dạng chủ sở hữu khoá học. Khi được chỉ định làm tham số của
Bạn phải đặt thuộc tính 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 |
creationTime |
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. 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ụ: |
updateTime |
Thời gian diễn ra lần cập nhật khoá học này gần đây nhất. 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. 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ụ: |
enrollmentCode |
Mã đăng ký để 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. |
courseState |
Trạng thái của khoá học. Nếu không chỉ định, trạng thái mặc định sẽ là |
alternateLink |
Đườ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. |
teacherGroupEmail |
Địa chỉ email của một nhóm Google gồm tất cả giáo viên tham gia 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. |
courseGroupEmail |
Địa chỉ email của một nhóm trên Google có chứa tất cả thành viên trong 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. |
teacherFolder |
Thông tin về một Thư mục trên Drive được chia sẻ với tất cả giáo viên trong khoá học. Trường này sẽ chỉ được đặt cho giáo viên của khoá học và quản trị viên miền. Chỉ đọc. |
courseMaterialSets[] |
Nhóm tài liệu xuất hiện trên trang "giới thiệu" của khoá học này. Chỉ đọc. |
guardiansEnabled |
Cho biết có bật thông báo dành cho người giám hộ đối với khoá học này hay không. Chỉ đọc. |
calendarId |
Mã lịch của lịch mà tất cả thành viên khoá học đều có thể nhìn thấy để Lớp học có thể thêm sự kiện cho bài tập và thông báo trong khoá học. Lịch cho khoá học được tạo không đồng bộ khi khoá học được đặt thành Chỉ đọc. |
gradebookSettings |
Chế độ cài đặt sổ điểm cho biết cách tính tổng điểm của học viên trong khoá học và hiển thị điểm cho ai. Chỉ có thể đọc |
CourseState
Các trạng thái có thể của khoá học.
Enum | |
---|---|
COURSE_STATE_UNSPECIFIED |
Không có trạng thái khoá học. Không có thông báo nào được trả về về Khoá học sẽ sử dụng giá trị này. |
ACTIVE |
Khoá học này đang hoạt động. |
ARCHIVED |
Khoá học đã được lưu trữ. Bạn không thể sửa đổi nó trừ phi thay đổi nó sang một trạng thái khác. |
PROVISIONED |
Khoá học đã được tạo nhưng chưa được kích hoạt. Giáo viên chính và quản trị viên miền có thể truy cập được. Họ có thể sửa đổi hoặc thay đổi lớp này sang trạng thái ACTIVE hoặc DECLINED . Bạn chỉ có thể thay đổi một khoá học thành PROVISIONED nếu khoá học ở trạng thái DECLINED . |
DECLINED |
Khoá học đã được tạo nhưng bị từ chối. Chủ sở hữu khoá học và quản trị viên miền có thể truy cập được, mặc dù tệp này sẽ không hiển thị trong giao diện người dùng web. Bạn không thể sửa đổi khoá học ngoại trừ việc thay đổi khoá sang trạng thái PROVISIONED . Bạn chỉ có thể thay đổi một khoá học thành DECLINED nếu khoá học ở trạng thái PROVISIONED . |
SUSPENDED |
Khoá học đã bị tạm ngưng. Bạn không thể sửa đổi khoá học và chỉ người dùng do ownerId xác định mới có thể xem khoá học. Một khoá học có thể được đặt ở trạng thái này nếu có khả năng vi phạm Điều khoản dịch vụ. |
CourseMaterialSet
Một bộ tài liệu sẽ xuất hiện trên trang "Giới thiệu" của khoá học. Những tài liệu này có thể bao gồm chương trình học, lịch trình hoặc thông tin cơ bản khác liên quan đến toàn bộ khoá học.
Biểu diễn dưới dạng JSON |
---|
{
"title": string,
"materials": [
{
object ( |
Các trường | |
---|---|
title |
Tiêu đề của tập hợp này. |
materials[] |
Tài liệu được đính kèm với bộ này. |
CourseMaterial
Một tài liệu được đính kèm vào khoá học trong bộ tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm material . Dữ liệu quan trọng. material chỉ có thể là một trong những trạng thái sau đây: |
|
driveFile |
Tệp đính kèm trên Google Drive. |
youTubeVideo |
Tệp đính kèm video trên YouTube. |
link |
Cài đặt đường liên kết. |
form |
Tệp đính kèm trên Google Biểu mẫu. |
GradebookSettings
Chế độ cài đặt sổ điểm của một khoá học. Hãy xem bài viết này trong trung tâm trợ giúp để biết thông tin chi tiết.
Biểu diễn dưới dạng JSON |
---|
{ "calculationType": enum ( |
Các trường | |
---|---|
calculationType |
Cho biết cách tính tổng điểm. |
displaySetting |
Cho biết ai có thể xem tổng điểm. |
gradeCategories[] |
Loại điểm có sẵn cho bài tập trong khoá học. |
CalculationType
Các phương pháp tính tổng điểm có thể áp dụng.
Enum | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Chưa chỉ định phương thức nào. Hệ thống sẽ không bao giờ trả về dữ liệu này. |
TOTAL_POINTS |
Tổng điểm là tổng điểm chia cho tổng điểm bất kể loại điểm. |
WEIGHTED_CATEGORIES |
Tổng điểm là điểm trung bình có trọng số theo danh mục. |
DisplaySetting
Các chế độ cài đặt có thể dùng để hiển thị tổng điểm.
Enum | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
Chưa chỉ định chế độ cài đặt nào. Hệ thống sẽ không bao giờ trả về dữ liệu này. |
SHOW_OVERALL_GRADE |
Hiển thị tổng điểm trong sổ điểm và hồ sơ học viên cho cả giáo viên và học viên. |
HIDE_OVERALL_GRADE |
Không hiện tổng điểm trong sổ điểm hoặc hồ sơ học viên. |
SHOW_TEACHERS_ONLY |
Hiện tổng điểm cho giáo viên trong sổ điểm và hồ sơ học viên. Ẩn học viên trong hồ sơ học viên. |
Phương thức |
|
---|---|
|
Trả về việc người dùng có đủ điều kiện tạo tệp đính kèm bằng tiện ích bổ sung trong một khoá học nhất định hay không. |
|
Tạo khoá học. |
|
Xoá khoá học. |
|
Trả về một khoá học. |
|
Trả về danh sách các khoá học mà người dùng yêu cầu được phép xem. Chỉ những khoá học phù hợp với yêu cầu mới được xem. |
|
Cập nhật một hoặc nhiều trường trong một khoá học. |
|
Cập nhật một khoá học. |