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)
  },
  "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.
id

string

Giá trị nhận dạng do Lớp học chỉ định cho bài tập này, là giá trị 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ệ, có 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 này. Nếu được đặt, nội dung mô tả 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.

CourseWork 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 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 bài tập này.

Chỉ đọc.

Sử dụng RFC 3339, trong đó đầ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 độ 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 bài tập này.

Chỉ đọc.

Sử dụng RFC 3339, trong đó đầ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 độ 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".
dueDate

object (Date)

Ngày không bắt buộc (theo giờ UTC) mà học viên phải nộp bài tập của khoá học này. Bạn phải chỉ định thuộc tính này nếu dueTime được chỉ định.
dueTime

object (TimeOfDay)

Thời gian trong ngày (không bắt buộc), theo giờ UTC, mà học viên phải nộp bài tập này. Bạn phải chỉ định thuộc tính này nếu dueDate được chỉ định.
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.

Sử dụng RFC 3339, trong đó đầ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 độ 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".
maxPoints

number

Điểm tối đa cho bài tập này. Nếu bằng 0 hoặc không đượ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 bài tập này.

Loại được đặt khi bài tập trên lớp được tạo và không thể thay đổi.
associatedWithDeveloper

boolean

Liệu mục công việc của khoá học này có được liên kết với dự án trên Developer 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 của bài tập trên lớp. 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 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 giao bài tập trên lớp.
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 đã gửi. 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 bài tập trên lớp.

Chỉ đọc.
topicId

string

Giá trị nhận dạng cho chủ đề mà 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.
gradeCategory

object (GradeCategory)

Danh mục mà điểm của bài tập này đóng góp vào. Chỉ xuất hiện khi bạn đã chọn một danh mục cho bài tập trên lớp. Có thể được dùng để tính điểm tổng kết.

Chỉ đọc.
previewVersion

enum (PreviewVersion)

Chỉ có đầu ra. Phiên bản xem trước của API dùng để truy xuất tài nguyên này.
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:
assignment

object (Assignment)

Chi tiết về bài tập. Thông tin này chỉ được điền sẵn khi workType là ASSIGNMENT.

Chỉ đọc.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Thông tin chi tiết về câu hỏi trắc nghiệm. Đối với các thao tác đọc, trường này chỉ được điền sẵn khi workType là MULTIPLE_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 trên lớp có workType là MULTIPLE_CHOICE_QUESTION và không được đặt trường này trong trường hợp khác.
gradingPeriodId

string

Giá trị nhận dạng của khoảng thời gian chấm điểm được liên kết với bài tập.

  • Khi tạo, nếu không được chỉ định, mã nhận dạng giai đoạn chấm điểm sẽ được đặt dựa trên dueDate (hoặc scheduledTime nếu không đặt dueDate).
  • Để cho biết không có mối liên kết nào với khoảng thời gian 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ã giai đoạn chấm điểm hiện có trong khoá học.

CourseWorkState

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

Enum
COURSE_WORK_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 bài tập đã được xuất bản. Đây là trạng thái mặc định.
DRAFT Trạng thái của 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 có thể xem được 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 có thể xem đượ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ế độ sửa đổi có thể có đối với bài tập mà học viên đã gửi.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Không chỉ định chế độ sửa đổi. Giá trị này không bao giờ được trả về.
MODIFIABLE_UNTIL_TURNED_IN Học viên có thể chỉnh sửa bài tập trước khi nộp.
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 trên Drive nơi lưu trữ các tệp đính kèm trong bài tập mà học viên đã nộp. 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 chi tiết khác cho 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 trên lớp.

delete

 Xoá bài tập trên lớp.

get

 Trả lại bài tập trên lớp.

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 trên lớp mà người yêu cầu được phép xem.

modifyAssignees

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

patch

 Cập nhật một hoặc nhiều trường của bài tập trên lớp.