REST Resource: courses.courseWork

Tài nguyên: CourseWork

Bài tậ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 (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
Các trường
courseId

string

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

Chỉ đọc.

id

string

Mã nhận dạng do Lớp học chỉ định của 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 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 về bài tập trong khoá học này. Nếu được đặt, nội dung mô tả 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.

Khoá học không được có quá 20 mục tài liệu.

state

enum (CourseWorkState)

Trạng thái của 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 bài tập 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 của thay đổi gần đây nhất đối với bài tập của 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".

dueDate

object (Date)

Ngày không bắt buộc (theo giờ UTC) mà các bài nộp trong khoá học này đã đến hạn. Giá trị này phải được chỉ định nếu bạn đã chỉ định dueTime.

dueTime

object (TimeOfDay)

Thời gian không bắt buộc trong ngày (theo giờ UTC) mà nộp bài cho bài tập này đến hạn. Giá trị này phải được chỉ định nếu bạn đã chỉ định dueDate.

scheduledTime

string (Timestamp format)

Dấu thời gian không bắt buộc khi bài tập 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".

maxPoints

number

Điểm tối đa cho bài tập trong khoá học này. Nếu bằng 0 hoặc chưa được chỉ định, bài tập này sẽ được coi là chưa chấm điểm. Đây phải là một giá trị số nguyên không âm.

workType

enum (CourseWorkType)

Loại của bài tập trong khoá học này.

Loại này được đặt khi bài tập trong khoá học được tạo và không thể thay đổi.

associatedWithDeveloper

boolean

Liệu mục bài tập trong khoá học này có liên kết với dự án Play Console đưa ra yêu cầu hay không.

Hãy xem courseWork.create để biết thêm chi tiết.

Chỉ đọc.

assigneeMode

enum (AssigneeMode)

Chế độ người được giao bài tập của 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 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 giao bài tập của môn học.

submissionModificationMode

enum (SubmissionModificationMode)

Chế độ cài đặt để xác định thời điểm học viên được phép sửa đổi bài làm. Nếu không chỉ định, giá trị mặc định sẽ là MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

Giá trị nhận dạng của người dùng đã tạo tài liệu môn 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 trong khoá học này. Phải phù hợp với một chủ đề hiện có trong khoá học.

gradeCategory

object (GradeCategory)

Loại điểm của bài tập này. Chỉ trình bày khi bạn đã chọn một danh mục cho tài liệu môn học. Có thể dùng để tính tổng điểm.

Chỉ đọc.

Trường nhóm details. Thông tin bổ sung dành riêng cho một loại bài tập trong khoá học. details chỉ có thể là một trong những trạng thái sau đây:
assignment

object (Assignment)

Thông tin chi tiết về bài tập. Trường này chỉ được điền khi workTypeASSIGNMENT.

Chỉ đọc.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

Thông tin chi tiết về câu hỏi trắc nghiệm. Đối với thao tác đọc, trường này chỉ được điền khi workTypeMULTIPLE_CHOICE_QUESTION. Đối với các thao tác ghi, bạn phải chỉ định trường này khi tạo bài tập khoá học bằng workTypeMULTIPLE_CHOICE_QUESTION và không được đặt trường này nếu không có.

CourseWorkState

Các trạng thái có thể có của bài tập khoá học.

Enum
COURSE_WORK_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ác phẩm đã được xuất bản. Đây là trạng thái mặc định.
DRAFT Trạng thái của tác phẩm 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 bài tập ở trạng thái này.
DELETED Trạng thái của bài tập đã đượ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 thấy được bài tập ở trạng thái này. Công việc ở trạng thái này sẽ bị xoá sau một khoảng thời gian.

SubmissionModificationMode

Các chế độ mà học viên có thể sửa đổi khi nộp bài.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Chưa chỉ định chế độ sửa đổi. Hệ thống sẽ không bao giờ trả về dữ liệu này.
MODIFIABLE_UNTIL_TURNED_IN Bạn có thể chỉnh sửa bài tập đã nộp trước khi nộp.
MODIFIABLE Bạn có thể sửa đổi bài tập đã nộp bất cứ lúc nào.

Assignment

Thông tin bổ sung về bài tập.

Biểu diễn dưới dạng JSON
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Các trường
studentWorkFolder

object (DriveFolder)

Thư mục Drive dùng để lưu tệp đính kèm của các bài tập học viên nộp. Trang này chỉ dành cho giáo viên và quản trị viên của khoá học.

MultipleChoiceQuestion

Thông tin bổ sung cho các câu hỏi trắc nghiệm.

Biểu diễn dưới dạng JSON
{
  "choices": [
    string
  ]
}
Các trường
choices[]

string

Lựa chọn khả thi.

Phương thức

create

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

delete

Xoá một bài tập trong khoá học.

get

Trả về 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 bài tập khoá học mà người yêu cầu được phép xem.

modifyAssignees

Sửa đổi chế độ và các lựa chọn của người được giao của một bài tập.

patch

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