Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem tài liệu về tiện ích bổ sung để biết thêm thông tin.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

REST Resource: courses.courseWork

Tài nguyên: CourseWork
- Biểu diễn dưới dạng JSON
CourseWorkState
SubmissionModificationMode
Bài tập
- Biểu diễn dưới dạng JSON
MultipleChoiceQuestion
- Biểu diễn dưới dạng JSON
Phương thức

Tài nguyên: CourseWork

Bài tập trên lớ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

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`), "learningGoals": [ { object (`LearningGoal`) } ], "assignment": { object (`Assignment`) }, "multipleChoiceQuestion": { object (`MultipleChoiceQuestion`) } "gradingPeriodId": string }

{
  "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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": 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 bài tập này trong khoá học, riêng biệt cho từng khoá học. Chỉ có thể đọc.
`title`	`string` Tiêu đề của bài tập này trong khoá học. 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 trong khoá học. 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. 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 không được chỉ định, trạng thái mặc định là `DRAFT`.
`alternateLink`	`string` Đường liên kết tuyệt đối đến bài tập trên lớp này trong giao diện người dùng web của Lớp học. Trường này chỉ được điền sẵn nếu `state` là `PUBLISHED`. Chỉ có thể đọc.
`creationTime`	`string (Timestamp format)` Dấu thời gian khi bài tập này được tạo. Chỉ có thể đọc. Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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 trong khoá học này. Chỉ có thể đọc. Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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 đến hạn nộp bài tập 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 trong ngày (không bắt buộc, theo giờ UTC) mà bài tập này đến hạn nộp. 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. Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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ạn đặt giá trị là 0 hoặc không chỉ định, thì bài tập này được coi là không được 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 bài tập trên lớp được tạo và không thể thay đổi.
`associatedWithDeveloper`	`boolean` Liệu bài tập này có liên kết với dự á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ó 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 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 `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 nộp. Nếu không được chỉ định, giá trị mặc định 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 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 một danh mục đã được chọn cho tài liệu môn học. Có thể được dùng để tính điểm tổng thể. 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.
`learningGoals[]`	`object (LearningGoal)` Không bắt buộc. Bản dùng trước cho nhà phát triển: Được cung cấp trong Chương trình Bản dùng trước cho nhà phát triển của Google Workspace, cho phép bạn tiếp cận sớm một số tính năng. Tính năng này có trong `V1_20260316_PREVIEW` trở lên. Hãy xem bài viết Truy cập API xem trước để tìm hiểu thêm. Tham chiếu đến mọi mục tiêu học tập được đính kèm vào bài tập này trên lớp. Bài tập có thể có tối đa 10 mục tiêu học tập. Trường này chỉ được điền nếu bạn đặt `previewVersion` thích hợp.
Thông tin chi tiết bổ sung dành riêng cho một loại bài tập trong khoá học. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
`assignment`	`object (Assignment)` Chi tiết về việc chỉ định. Trường này chỉ được điền sẵ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 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 theo cách khác.
Kết thúc các trường loại trừ lẫn nhau.
`gradingPeriodId`	`string` Giá trị nhận dạng của giai đoạn chấm điểm liên kết với bài tập. Khi tạo, nếu bạn không 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 bạn không đặt `dueDate`). Để cho biết không có mối liên kết với bất kỳ giai đoạn chấm điểm nào, 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 trong khoá học.

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 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 có thể xem 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 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`	Chưa 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 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

Trường
`studentWorkFolder`	`object (DriveFolder)` Thư mục trên Drive chứa tệp đính kèm trong bài nộ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.

studentWorkFolder

object (DriveFolder)

Thư mục trên Drive chứa tệp đính kèm trong bài nộ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 cho câu hỏi trắc nghiệm.

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

Trường

Trường
`choices[]`	`string` Các lựa chọn có thể có.

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á một bài tập trên lớp.
`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 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 của người được giao cho một bài tập.
`patch`	Cập nhật một hoặc nhiều trường của bài tập trên lớp.

REST Resource: courses.courseWork

Tài nguyên: CourseWork

CourseWorkState

SubmissionModificationMode

Assignment

MultipleChoiceQuestion

Phương thức

`create`

`delete`

`get`

`getAddOnContext`

`list`

`modifyAssignees`

`patch`

REST Resource: courses.courseWork Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tài nguyên: CourseWork

CourseWorkState

SubmissionModificationMode

Assignment

MultipleChoiceQuestion

Phương thức

create

delete

get

getAddOnContext

list

modifyAssignees

patch

REST Resource: courses.courseWork

`create`

`delete`

`get`

`getAddOnContext`

`list`

`modifyAssignees`

`patch`