- Tài nguyên: Bài tập của học viên
- RubricGrade
- AssignmentSubmission
- Tệp đính kèm
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Trạng thái
- GradeHistory
- GradeChangeType
- Phương thức
Tài nguyên: Bài nộp của học viên
Bài tập học viên nộp cho bài tập trong khoá học.
StudentSubmission
mục sẽ được tạo khi tạo một mục CourseWork
.
Bài làm mà học viên chưa từng được truy cập (tức là với state
= MỚI) có thể không có thời gian tạo hoặc thời gian cập nhật.
Biểu diễn dưới dạng JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Các trường | |
---|---|
courseId |
Giá trị nhận dạng của khoá học. Chỉ đọc. |
courseWorkId |
Mã nhận dạng của bài tập trong khoá học tương ứng với mã này. Chỉ đọc. |
id |
Giá trị nhận dạng do Lớp học chỉ định cho bài nộp của học viên. Đây là điểm duy nhất trong số các bài nộp cho bài tập liên quan trong khoá học. Chỉ đọc. |
userId |
Giá trị nhận dạng của học viên sở hữu bài nộp này. Chỉ đọc. |
creationTime |
Thời gian tạo của nội dung gửi này. Bạn có thể không đặt chính sách này nếu học viên chưa truy cập vào mụ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ụ: |
updateTime |
Thời điểm cập nhật gần đây nhất của nội dung này. Bạn có thể không đặt chính sách này nếu học viên chưa truy cập vào mụ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ụ: |
state |
Trạng thái của nội dung gửi này. Chỉ đọc. |
late |
Liệu bài tập này có bị nộp muộn hay không. Chỉ đọc. |
draftGrade |
Điểm đang chờ xử lý không bắt buộc. Nếu bạn không đặt chính sách này thì sẽ không có điểm nào được đặt. Giá trị này không được là số âm. Giá trị thập phân (nghĩa là không phải số nguyên) được cho phép, nhưng được làm tròn đến hai chữ số thập phân. Chỉ giáo viên của khoá học mới có thể xem và sửa đổi nội dung này. |
assignedGrade |
Điểm không bắt buộc. Nếu bạn không đặt chính sách này thì sẽ không có điểm nào được đặt. Giá trị này không được là số âm. Giá trị thập phân (nghĩa là không phải số nguyên) được cho phép, nhưng được làm tròn đến hai chữ số thập phân. Chỉ giáo viên của khoá học mới có thể sửa đổi chế độ này. |
rubricId |
Chỉ có đầu ra. Mã nhận dạng của tiêu chí chấm điểm hiện được đính kèm với bài tập trong khoá học này và được dùng để chấm điểm bài tập này của học viên. Mã này trống nếu không có tiêu chí chấm điểm. Mã này phản ánh tiêu chí chấm điểm hiện đang hoạt động và sẽ thay đổi nếu giáo viên xoá và tạo lại tiêu chí chấm điểm. Chỉ đọc. |
draftRubricGrades |
Điểm theo tiêu chí chấm điểm đang chờ xử lý dựa trên tiêu chí của tiêu chí chấm điểm đó. Bản đồ này trống nếu không có tiêu chí chấm điểm đính kèm với bài tập trong khoá học này hoặc nếu có tiêu chí chấm điểm được đính kèm nhưng chưa có tiêu chí nào được đặt điểm. Mục nhập chỉ được điền cho điểm đã đặt. Khoá: Mã tiêu chí của tiêu chí chấm điểm. Chỉ đọc. Một đối tượng chứa danh sách các cặp |
assignedRubricGrades |
Đã chỉ định điểm theo tiêu chí chấm điểm dựa trên Tiêu chí của tiêu chí chấm điểm đó. Bản đồ này trống nếu không có tiêu chí chấm điểm đính kèm với bài tập trong khoá học này hoặc nếu có tiêu chí chấm điểm được đính kèm nhưng chưa có điểm nào được đặt cho bất kỳ Tiêu chí nào. Mục nhập chỉ được điền cho điểm đã đặt. Khoá: Mã tiêu chí của tiêu chí chấm điểm. Chỉ đọc. Một đối tượng chứa danh sách các cặp |
alternateLink |
Đường liên kết tuyệt đối đến bài tập đã nộp trong giao diện người dùng web của Lớp học. Chỉ đọc. |
courseWorkType |
Loại bài tập trong khoá học mà nội dung gửi này là dành cho. Chỉ đọc. |
associatedWithDeveloper |
Liệu bài nộp này của học viên có liên kết với dự án Play Console đưa ra yêu cầu hay không. Hãy xem Chỉ đọc. |
submissionHistory[] |
Quá trình học bài (bao gồm cả nhật ký cấp tiểu bang và điểm số). Chỉ đọc. |
previewVersion |
Chỉ có đầu ra. Phiên bản xem trước của API. Bạn phải đặt khoá này để có thể sử dụng các tính năng API mới dành cho nhà phát triển trong Chương trình dùng thử. |
Trường nhóm content . Nội dung gửi. Loại cụ thể phụ thuộc vào giá trị của course_work_type . content chỉ có thể là một trong những trạng thái sau đây: |
|
assignmentSubmission |
Nội dung gửi khi khóa họcWorkType là Assignment. Học viên có thể sửa đổi nội dung này bằng |
shortAnswerSubmission |
Nội dung gửi khicourseWorkType là SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
Nội dung gửi khi CourseWorkType là MULTIPLE_CHOICE_QUESTION. |
RubricGrade
Điểm theo tiêu chí chấm điểm mà học viên đã đặt. Có tối đa một mục nhập cho mỗi tiêu chí tiêu chí chấm điểm.
Biểu diễn dưới dạng JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
Các trường | |
---|---|
criterionId |
Không bắt buộc. ID tiêu chí. |
levelId |
Không bắt buộc. Mã cấp không bắt buộc của cấp đã chọn. Nếu trống thì tức là không có cấp nào được chọn. |
points |
Không bắt buộc. Điểm không bắt buộc được chỉ định cho tiêu chí này, thường dựa trên cấp. Cấp có thể có hoặc không có điểm. Nếu bạn không đặt chính sách này thì sẽ không có điểm nào được đặt cho tiêu chí này. |
AssignmentSubmission
Bài tập của học viên trong một bài tập.
Biểu diễn dưới dạng JSON |
---|
{
"attachments": [
{
object ( |
Các trường | |
---|---|
attachments[] |
Tệp đính kèm do học viên thêm. Các tệp trên Drive tương ứng với tài liệu có chế độ chia sẻ ưu đãi sơ_ yếu tố có thể chưa tồn tại nếu học viên chưa truy cập vào bài tập trong Lớp học. Một số siêu dữ liệu của tệp đính kèm chỉ được điền nếu người dùng yêu cầu có quyền truy cập vào tệp đó. Các trường giá trị nhận dạng và đường liên kết thay thế luôn có sẵn, nhưng các trường khác (ví dụ: tiêu đề) thì có thể không có. |
Tệp đính kèm
Đã thêm tệp đính kèm vào bài tập của học viên.
Khi tạo tệp đính kèm, việc đặt trường form
không được hỗ trợ.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm attachment . Dữ liệu tệp đính kèm. attachment chỉ có thể là một trong những trạng thái sau đây: |
|
driveFile |
Tệp đính kèm trên Google Drive. |
youTubeVideo |
Tệp đính kèm video trên YouTube. |
link |
Tệp đính kèm đường liên kết. |
form |
Tệp đính kèm trên Google Biểu mẫu. |
ShortAnswerSubmission
Bài tập của học viên cho một câu hỏi trả lời ngắn.
Biểu diễn dưới dạng JSON |
---|
{ "answer": string } |
Các trường | |
---|---|
answer |
Phản hồi của học viên cho câu hỏi trả lời ngắn. |
MultipleChoiceSubmission
Bài tập của học viên cho một câu hỏi trắc nghiệm.
Biểu diễn dưới dạng JSON |
---|
{ "answer": string } |
Các trường | |
---|---|
answer |
Lựa chọn của học viên. |
SubmissionHistory
Nhật ký gửi. Dữ liệu này hiện bao gồm cả lịch sử tiểu bang và điểm.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm type . Type of SubmissionLịch sử, có thể là một trong các State History, Grade History. type chỉ có thể là một trong những trạng thái sau đây: |
|
stateHistory |
Thông tin về nhật ký trạng thái của nội dung gửi, nếu có. |
gradeHistory |
Thông tin về nhật ký điểm của bài nộp, nếu có. |
StateHistory
Lịch sử của mỗi tiểu bang mà nội dung gửi này đã được gửi.
Biểu diễn dưới dạng JSON |
---|
{
"state": enum ( |
Các trường | |
---|---|
state |
Giai đoạn của quy trình công việc. |
stateTimestamp |
Khi nội dung gửi chuyển sang trạng thái này. 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ụ: |
actorUserId |
Giáo viên hoặc học viên đã thực hiện thay đổi. |
Tiểu bang
Các trạng thái mà bài tập có thể nộp.
Enum | |
---|---|
STATE_UNSPECIFIED |
Chưa chỉ định tiểu bang nào. Dữ liệu này sẽ không bao giờ được trả về. |
CREATED |
Nội dung gửi đã được tạo. |
TURNED_IN |
Học viên đã nộp một tài liệu được giao. Tài liệu này có thể là mẫu hoặc không. |
RETURNED |
Giáo viên đã trả lại tài liệu được giao cho học viên. |
RECLAIMED_BY_STUDENT |
Học viên đã nộp tài liệu được giao rồi chọn "huỷ gửi" bài tập đó để học viên lại có quyền kiểm soát với tư cách là chủ sở hữu. |
STUDENT_EDITED_AFTER_TURN_IN |
Học viên đã chỉnh sửa bài nộp sau khi nộp. Hiện tại, tính năng này chỉ được dùng trong phần Câu hỏi, khi học viên chỉnh sửa câu trả lời. |
GradeHistory
Nhật ký của từng điểm trong bài nộp này.
Biểu diễn dưới dạng JSON |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
Các trường | |
---|---|
pointsEarned |
tử số của điểm tại thời điểm này trong lịch sử điểm đã nộp. |
maxPoints |
Mẫu số của điểm tại thời điểm này trong lịch sử điểm đã nộp. |
gradeTimestamp |
Thời điểm thay đổi điểm của bài tập. 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ụ: |
actorUserId |
Giáo viên đã thay đổi điểm. |
gradeChangeType |
Kiểu thay đổi điểm hiện tại trong nhật ký điểm bài tập. |
GradeChangeType
Các loại thay đổi điểm có thể có.
Enum | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
Chưa chỉ định kiểu thay đổi điểm. Dữ liệu này sẽ không bao giờ được trả về. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
Nội dung thay đổi ở tử số của điểm không chính thức. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
Nội dung thay đổi ở tử số của điểm được chỉ định. |
MAX_POINTS_CHANGE |
Thay đổi về mẫu số của điểm. |
Phương thức |
|
---|---|
|
Trả về bài nộp của học viên. |
|
Trả về danh sách các bài tập mà học viên đã nộp mà người yêu cầu được phép xem, có tính đến phạm vi OAuth của yêu cầu. |
|
Sửa đổi các tệp đính kèm mà học viên đã nộp. |
|
Cập nhật một hoặc nhiều trường trong bài tập học viên nộp. |
|
Xác nhận lại bài tập mà học viên đã nộp thay mặt cho học viên sở hữu bài tập đó. |
|
Trả về bài nộp của học viên. |
|
Nộp bài của học viên. |