REST Resource: courses.courseWork

Tài nguyên: CourseWork

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 (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)
  },
  "previewVersion": enum (PreviewVersion),

  // 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.
  "gradingPeriodId": string
}
Trường
courseId

string

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

Chỉ có thể đọc.

id

string

Mã nhận dạng do Lớp học chỉ định cho 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 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

Nội dung 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ệ và không được quá 30.000 ký tự.

materials[]

object (Material)

Tài liệu bổ sung.

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

dueDate

object (Date)

Ngày đến hạn nộp bài (không bắt buộc) theo giờ UTC. Bạn phải chỉ định thuộc tính này nếu đã chỉ định dueTime.

dueTime

object (TimeOfDay)

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

scheduledTime

string (Timestamp format)

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

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".

maxPoints

number

Điểm tối đa của bài tập trong khoá học này. Nếu không hoặc chưa 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 bài tập của 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 Developer Console đang gửi yêu cầu hay không.

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

Chỉ có thể đọc.

assigneeMode

enum (AssigneeMode)

Chế độ người được giao của tài liệu môn 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 môn 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 tài liệu 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 tập đã nộp. Nếu bạn 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ó thể đọc.

topicId

string

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

gradeCategory

object (GradeCategory)

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

Chỉ có thể đọc.

previewVersion

enum (PreviewVersion)

Chỉ có đầu ra. Phiên bản xem trước của API được dùng để truy xuất tài nguyên này.

Trường kết hợp details. Thông tin chi tiết bổ sung liên quan đến 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)

Chi tiết về việc chỉ định. Thông tin này chỉ được điền khi workTypeASSIGNMENT.

Chỉ có thể đọc.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

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

gradingPeriodId

string

Giá trị nhận dạng của giai đoạn chấm điểm liên kết với tài liệu môn học.

  • Nếu bạn chưa chỉ định, mã giai đoạn chấm điểm sẽ được đặt dựa trên dueDate (hoặc scheduledTime nếu bạn không đặt dueDate).
  • Để cho biết rằng không có mối liên kết nào với giai đoạn chấm điểm, hãy đặt trường này thành một chuỗi trống ("").
  • Nếu được chỉ định, mã này phải khớp với một mã giai đoạn chấm điểm hiện có trong khoá học.

CourseWorkState

Tất nhiên các trạng thái có thể có là hoạt động.

Enum
COURSE_WORK_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 các tác phẩm đã 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 nhìn thấy bài tập ở trạng thái này.
DELETED Trạng thái của tác phẩm đã đượ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 nhìn thấy 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ế độ sửa đổi có thể áp dụng cho bài làm học viên nộp.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Chưa chỉ định chế độ sửa đổi. Giá trị này sẽ không bao giờ được trả về.
MODIFIABLE_UNTIL_TURNED_IN Bạn có thể sửa đổi nội dung đã gửi trước khi gửi.
MODIFIABLE Bạn có thể sửa đổi nội dung đã gửi 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)
  }
}
Trường
studentWorkFolder

object (DriveFolder)

Thư mục Drive chứa tệp đính kèm từ bài tập của học viên. Thông tin này chỉ được điền sẵn cho giáo viên và quản trị viên của khoá học.

MultipleChoiceQuestion

Thông tin bổ sung đối với câu hỏi trắc nghiệm.

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

string

Các lựa chọn có thể có.

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

modifyAssignees

Sửa đổi chế độ được giao và các tuỳ chọn cho tài liệu môn học.

patch

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