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
}
Trường
courseId

string

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

Chỉ có thể đọ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 trong khoá học này (giá trị nhận dạng riêng biệt cho mỗi khoá học).

Chỉ có thể đọ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ệ có chứa từ 1 đến 3.000 ký tự.

description

string

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

materials[]

object (Material)

Tài liệu bổ sung.

Một tài liệu khoá học không được chứa quá 20 mục material.

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 khi tài liệu của khoá học này được tạo.

Chỉ có thể đọc.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 trong khoá học này.

Chỉ có thể đọc.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 cho 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)

Giá trị 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 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 về bài tập khoá học.

creatorUserId

string

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

Chỉ có thể đọc.

topicId

string

Giá trị nhận dạng cho chủ đề có liên kết với tài liệu bài tập trong khoá học này. Phải khớp với 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 khoá học

Enum
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Chưa chỉ định tiểu bang nào. Giá trị này sẽ không bao giờ được trả về.
PUBLISHED Trạng thái của tài liệu bài tập khoá học đã xuất bản. Đây là trạng thái mặc định.
DRAFT Trạng thái của tài liệu bài tập khoá học 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 có thể xem tài liệu của 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 khoá học đã được xuất bản 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 có thể xem tài liệu của bài tập ở trạng thái này. Tài liệu của bài tậ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 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 về các tiện ích bổ sung cho Google Lớp học trong ngữ 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 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 khoá học.