- 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 ( |
Trường | |
---|---|
id |
Giá trị nhận dạng cho khoá học do Lớp học chỉ định này. 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 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ệ. |
section |
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ự. |
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 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ự. |
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 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ự. |
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 được dài quá 650 ký tự. |
ownerId |
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
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 |
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ó 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ụ: |
updateTime |
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ụ: |
enrollmentCode |
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. |
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à |
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ó thể đọc. |
teacherGroupEmail |
Đị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. |
courseGroupEmail |
Đị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. |
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 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. |
courseMaterialSets[] |
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. |
guardiansEnabled |
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. |
calendarId |
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 Chỉ có thể đọc. |
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 |
CourseState
Các trạng thái có thể có của một khoá học.
Enum | |
---|---|
COURSE_STATE_UNSPECIFIED |
Không có trạng thái khoá học. Không có thông báo Khoá học nào được trả về sẽ sử dụng giá trị này. |
ACTIVE |
Khoá học đang diễn ra. |
ARCHIVED |
Khoá học đã được lưu trữ. Bạn không thể sửa đổi miền ngoại trừ việc đổi miền sang 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 vào tệp này. Những người này có thể sửa đổi hoặc thay đổi tệp thành trạng thái ACTIVE hoặc DECLINED . Một khoá học chỉ có thể được thay đổi 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 tệp này, mặc dù tệp 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 trừ phi thay đổi khoá học sang trạng thái PROVISIONED . Một khoá học chỉ có thể được thay đổi 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ể bị chuyển sang 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 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 biểu hoặc thông tin cơ bản khác liên quan đến toàn bộ khóa học.
Biểu diễn dưới dạng JSON |
---|
{
"title": string,
"materials": [
{
object ( |
Trường | |
---|---|
title |
Tiêu đề cho loạt video này. |
materials[] |
Tài liệu đính kèm với tập hợp này. |
CourseMaterial
Một tài liệu đính kèm vào một khoá học trong bộ tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường kết hợp material . Dữ liệu Material. 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 |
Tùy chọn 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 cho một khoá học. Hãy xem bài viết này trong trung tâm trợ giúp để biết thêm chi tiết.
Biểu diễn dưới dạng JSON |
---|
{ "calculationType": enum ( |
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[] |
Danh mục đ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ể dùng.
Enum | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Chưa chỉ định phương thức nào. Giá trị này sẽ không bao giờ được trả về. |
TOTAL_POINTS |
Tổng điểm là tổng điểm chia cho tổng điểm bất kể danh mục. |
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. Giá trị này sẽ không bao giờ được trả về. |
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 thị tổng điểm cho giáo viên xem trong sổ điểm và hồ sơ học viên. Ẩn khỏi 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. |
|
Trả về việc người dùng có đủ điều kiện để cập nhật GradeingPeriodSettings trong một khoá học nhất định hay không. |
|
Tạo khoá học. |
|
Xoá một khoá học. |
|
Trả về một khoá học. |
|
Trả về chế độ cài đặt giai đoạn chấm điểm trong 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, giới hạn cho những khoá học phù hợp với yêu cầu. |
|
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. |
|
Cập nhật chế độ cài đặt giai đoạn chấm điểm của một khoá học. |