REST Resource: courses.courseWorkMaterials

Tài nguyên: CourseWorkMaterial

Tài liệu bài tập trên lớp 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,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
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 cho tài liệu bài tập trên lớp này, riêng biệt theo từng khoá học.

Chỉ đọc.
title

string

Tiêu đề của tài liệu bài tập trên lớp này. Tiêu đề phải là một chuỗi UTF-8 hợp lệ, có từ 1 đến 3.000 ký tự.
description

string

Nội dung mô tả không bắt buộc về tài liệu bài tập này. Văn bản phải là một chuỗi UTF-8 hợp lệ,không được chứa quá 30.000 ký tự.
materials[]

object (Material)

Tài liệu bổ sung.

Một tài liệu bài tập trên lớp 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 bạn không chỉ định, trạng thái mặc định sẽ là DRAFT.
creationTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm tạo tài liệu bài tập này.

Chỉ đọc.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Dấu thời gian của thay đổi gần đây nhất đối với tài liệu bài tập này.

Chỉ đọc.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Dấu thời gian không bắt buộc khi tài liệu bài tập này được lên lịch xuất bản.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

Mã nhận dạng của học viên có quyền truy cập vào tài liệu bài tập trên lớp. Trường này chỉ được đặt nếu assigneeMode là INDIVIDUAL_STUDENTS. Nếu assigneeMode là INDIVIDUAL_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 bài tập trên lớp.
creatorUserId

string

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

Chỉ đọc.
topicId

string

Mã nhận dạng của chủ đề mà tài liệu bài tập này được liên kết. Phải khớp với một chủ đề hiện có trong khoá học.
learningGoals[]

object (LearningGoal)

Không bắt buộc.

Thông tin tham khảo về mọi mục tiêu học tập được đính kèm vào tài liệu bài tập trên lớp này. CourseWorkMaterial có thể có tối đa 10 mục tiêu học tập. Trường này chỉ được điền sẵn nếu bạn đặt previewVersion thích hợp.

CourseWorkMaterialState

Các trạng thái có thể có của tài liệu bài tập trên lớp

Enum
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Chưa chỉ định tiểu bang. Giá trị này không bao giờ được trả về.
PUBLISHED Trạng thái của tài liệu bài tập đã được đăng. Đây là trạng thái mặc định.
DRAFT Trạng thái của một tài liệu bài tập chưa được xuất bản. Chỉ giáo viên của khoá học và quản trị viên miền mới thấy được tài liệu bài tập ở trạng thái này.
DELETED Trạng thái của tài liệu bài tập đã được đăng nhưng hiện đã bị xoá. Chỉ giáo viên của khoá học và quản trị viên miền mới thấy được tài liệu bài tập ở trạng thái này. Tài liệu bài tập trên lớp ở 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 bài tập trên lớp.

delete

 Xoá một tài liệu bài tập trên lớp.

get

 Trả về tài liệu bài tập trên lớp.

getAddOnContext

 Lấy siêu dữ liệu cho tiện ích bổ sung 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 bài tập 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 trên lớp.