REST Resource: courses.courseWorkMaterials

Tài nguyên: CourseWorkMaterial

Tài liệu bài tập khoá học do giáo viên tạo cho học viên của khoá học

Biểu diễn dưới dạng JSON
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string
}
Các trường
courseId

string

Giá trị nhận dạng của khoá học.

Chỉ đọc.

id

string

Giá trị nhận dạng do Lớp học chỉ định của tài liệu bài tập trong khoá học này, duy nhất cho mỗi khoá học.

Chỉ đọc.

title

string

Tên của tài liệu bài tập trong khoá học này. Tiêu đề phải là một chuỗi UTF-8 hợp lệ, chứa từ 1 đến 3000 ký tự.

description

string

Phần mô tả không bắt buộc cho tài liệu bài tập trong khoá học này. Văn bản phải là một chuỗi UTF-8 hợp lệ chứa không quá 30.000 ký tự.

materials[]

object (Material)

Tài liệu bổ sung.

Tài liệu bài tập khoá học không được có quá 20 mục tài liệu.

state

enum (CourseWorkMaterialState)

Trạng thái của tài liệu bài tập trong khoá học này. Nếu không chỉ định, trạng thái mặc định sẽ là DRAFT.

creationTime

string (Timestamp format)

Dấu thời gian khi tài liệu bài tập trong khoá học này được tạo.

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ụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Dấu thời gian về thay đổi gần đây nhất đối với tài liệu bài tập trong khoá học này.

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ụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

scheduledTime

string (Timestamp format)

Dấu thời gian (không bắt buộc) khi tài liệu của bài tập trong khoá học này được lên lịch xuất bản.

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""2014-10-02T15:01:23.045123456Z".

assigneeMode

enum (AssigneeMode)

Chế độ người được giao của tài liệu bài tập trong khoá học. Nếu không chỉ định, giá trị mặc định sẽ là ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Giá trị nhận dạng của những học viên có quyền truy cập vào tài liệu của bài tập trong khoá học. Trường này chỉ được đặt nếu assigneeModeINDIVIDUAL_STUDENTS. Nếu assigneeModeINDIVIDUAL_STUDENTS, thì chỉ những học viên được chỉ định trong trường này mới có thể xem tài liệu của bài tập trong khoá học.

creatorUserId

string

Giá trị nhận dạng của người dùng đã tạo tài liệu cho bài tập trong khoá học.

Chỉ đọc.

topicId

string

Giá trị nhận dạng của chủ đề liên kết với tài liệu bài tập trong khoá học này. Phải phù hợp với một chủ đề hiện có trong khoá học.

CourseWorkMaterialState

Các trạng thái có thể có của tài liệu bài tập môn học

Enum
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Chưa chỉ định tiểu bang nào. Hệ thống sẽ không bao giờ trả về dữ liệu này.
PUBLISHED Trạng thái của tài liệu về bài tập trong khoá học đã được xuất bản. Đây là trạng thái mặc định.
DRAFT Trạng thái của một tài liệu của bài tập trong khoá học chưa được xuất bản. Tài liệu bài tập khoá học ở trạng thái này chỉ hiển thị với giáo viên của khoá học và quản trị viên miền.
DELETED Trạng thái của tài liệu về bài tập khoá học đã được xuất bản nhưng hiện đã bị xoá. Tài liệu bài tập khoá học ở trạng thái này chỉ hiển thị với giáo viên của khoá học và quản trị viên miền. Tài liệu của bài tập khoá học ở trạng thái này sẽ bị xoá sau một khoảng thời gian.

Phương thức

create

Tạo tài liệu cho bài tập trong khoá học.

delete

Xoá tài liệu của bài tập trong khoá học.

get

Trả về tài liệu của bài tập trong khoá học.

getAddOnContext

Lấy siêu dữ liệu cho các tiện ích bổ sung của Lớp học trong bối cảnh của một bài đăng cụ thể.

list

Trả về danh sách tài liệu của bài tập khoá học mà người yêu cầu được phép xem.

patch

Cập nhật một hoặc nhiều trường của tài liệu bài tập trong khoá học.