REST Resource: courses.courseWork

Tài nguyên: Bài tập

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ó thể đọc.
id

string

Mã nhận dạng do Lớp học chỉ định cho bài tập này, mỗi khoá học có một mã nhận dạng riêng.

Chỉ có thể đọ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 3.000 ký tự.
description

string

Nội dung mô tả không bắt buộc về bài tập của 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.

Bài tập không được có nhiều hơn 20 mục nội dung.
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ó thể đọc.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "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 này trong khoá học.

Chỉ có thể đọc.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
dueDate

object (Date)

Ngày đến hạn gửi bài tập của khoá học này (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 (không bắt buộc) theo giờ UTC mà bạn phải gửi bài tập cho khoá học này. 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 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, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
maxPoints

number

Điểm tối đa cho bài tập này. Nếu bạn không chỉ định hoặc chỉ định giá trị 0, 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 này được đặt khi tạo bài tập và không thể thay đổi.
associatedWithDeveloper

boolean

Mục bài tập này có được liên kết với dự án trên Developer Console đang đưa ra 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 bài tập. Nếu không được 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. 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.
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 không được chỉ định, giá trị mặc định sẽ là MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Giá trị nhận dạng cho người dùng đã tạo bài tập.

Chỉ có thể đọc.
topicId

string

Giá trị nhận dạng cho chủ đề liên kết với bài tập này. 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 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 dùng để truy xuất tài nguyên này.
Trường hợp hợp nhất 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 loại sau:
assignment

object (Assignment)

Chi tiết về bài tập. Giá trị này chỉ được điền khi workType là ASSIGNMENT.

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 các thao tác đọc, trường này chỉ được điề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 bằng workType là MULTIPLE_CHOICE_QUESTION và không được đặt trường này nếu không.
gradingPeriodId

string

Giá trị nhận dạng của kỳ chấm điểm liên kết với bài tập.

  • Nếu không 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 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ã kỳ đánh giá hiện có trong khoá học.

CourseWorkState

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

Enum
COURSE_WORK_STATE_UNSPECIFIED Chưa chỉ định trạng thái. Giá trị này không bao giờ được trả về.
PUBLISHED Trạng thái của tác phẩm đã xuất bản. Đây là trạng thái mặc định.
DRAFT Trạng thái của công việc chưa được xuất bản. Chỉ giáo viên 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 công việc đã được xuất bản nhưng hiện đã bị xoá. Chỉ giáo viên 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ế độ sửa đổi có thể áp dụng cho bài nộp của học viên.

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 Bạn có thể sửa đổi bài nộp 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 trên Drive nơi lưu trữ các tệp đính kèm trong bài nộp của học viên. Trường 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 về 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á bài tập trong khoá học.

get

 Trả về bài tập của 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 ngữ cảnh của một bài đăng cụ thể.

list

 Trả về danh sách bài tập trong khoá học mà người yêu cầu được phép xem.

modifyAssignees

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

patch

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