REST Resource: courses.courseWork.studentSubmissions

Tài nguyên: StudentSubmission

Bài tập học viên gửi cho bài tập trên lớp.

Các mục StudentSubmission được tạo khi một mục CourseWork được tạo.

Bài tập mà học viên gửi chưa từng được truy cập (tức là có state = NEW) 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 (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Trường
courseId

string

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

Chỉ đọc.
courseWorkId

string

Giá trị nhận dạng của bài tập tương ứng.

Chỉ đọc.
id

string

Giá trị nhận dạng do Lớp học chỉ định cho bài tập đã nộp của học viên. Giá trị này là duy nhất trong số các bài tập đã nộp của khoá học có liên quan.

Chỉ đọc.
userId

string

Giá trị nhận dạng của học viên sở hữu bài tập đã nộp này.

Chỉ đọc.
creationTime

string (Timestamp format)

Thời gian tạo nội dung gửi này. Giá trị này có thể chưa được đặt nếu học viên chưa truy cập vào mục 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)

Thời gian cập nhật gần đây nhất của yêu cầu này. Giá trị này có thể chưa được đặt nếu học viên chưa truy cập vào mục 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".
state

enum (SubmissionState)

Trạng thái của bài nộp này.

Chỉ đọc.
late

boolean

Cho biết bài tập có bị nộp muộn hay không.

Chỉ đọc.
draftGrade

number

Điểm đang chờ xử lý (không bắt buộc). Nếu bạn không đặt, thì không có điểm nào được đặt. Giá trị này phải là giá trị không âm. Bạn có thể dùng giá trị thập phân (tức là giá trị không phải số nguyên), nhưng giá trị này sẽ được làm tròn đến 2 chữ số thập phân.

Chỉ giáo viên của khoá học mới có thể nhìn thấy và sửa đổi thông tin này.
assignedGrade

number

Điểm không bắt buộc. Nếu bạn không đặt, thì không có điểm nào được đặt. Giá trị này phải là giá trị không âm. Bạn có thể dùng giá trị thập phân (tức là giá trị không phải số nguyên), nhưng giá trị này sẽ được làm tròn đến 2 chữ số thập phân.

Chỉ giáo viên của khoá học mới có thể sửa đổi thông tin này.
rubricId

string

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ào bài tập trên lớp này và được dùng để chấm điểm bài tập mà học viên gửi.

Mã này sẽ trống nếu không có tiêu chí chấm điểm. Mã này phản ánh bảng điểm hiện đang hoạt động; mã này sẽ thay đổi nếu giáo viên xoá và tạo lại bảng điểm.

Chỉ đọc.

draftRubricGrades

map (key: string, value: object (RubricGrade))

Điểm chấm theo bảng điểm đang chờ xử lý dựa trên các tiêu chí của bảng điểm.

Bản đồ này sẽ trống nếu không có tiêu chí chấm điểm nào được đính kèm vào bài tập 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. Hệ thống chỉ điền sẵn các mục cho những điểm đã được đặt. Khoá: Mã tiêu chí của bảng điểm.

Chỉ đọc.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Điểm chấm theo bảng điểm được chỉ định dựa trên Tiêu chí của bảng điểm.

Bản đồ này sẽ trống nếu không có tiêu chí chấm điểm nào được đính kèm vào bài tập 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. Hệ thống chỉ điền sẵn các mục cho những điểm đã được đặt. Khoá: Mã tiêu chí của bảng điểm.

Chỉ đọc.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Loại bài tập mà bài nộp này dành cho.

Chỉ đọc.
associatedWithDeveloper

boolean

Liệu bài tập đã gửi của học viên 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.
submissionHistory[]

object (SubmissionHistory)

Nhật ký của bài tập đã nộp (bao gồm nhật ký trạng thái và điểm).

Chỉ đọc.
previewVersion

enum (PreviewVersion)

Chỉ có đầu ra. Phiên bản xem trước của API. Bạn phải đặt giá trị này để truy cập vào các chức năng API mới được cung cấp 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:
assignmentSubmission

object (AssignmentSubmission)

Nội dung bài tập khi courseWorkType là ASSIGNMENT.

Học viên có thể sửa đổi nội dung này bằng studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Nội dung bài tập khi courseWorkType là SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Nội dung bài tập khi courseWorkType là MULTIPLE_CHOICE_QUESTION.

RubricGrade

Điểm theo thang điểm được đặt cho bài mà học viên đã gửi. Mỗi tiêu chí chấm điểm chỉ có tối đa một mục.

Biểu diễn dưới dạng JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Trường
criterionId

string

Không bắt buộc. Mã tiêu chí.
levelId

string

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, tức là bạn chưa chọn cấp độ nào.
points

number

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ác cấp độ có thể có hoặc không có điểm. Nếu bạn không đặt, 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 cho một bài tập.

Biểu diễn dưới dạng JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Trường
attachments[]

object (Attachment)

Học viên đã thêm tệp đính kèm. Các tệp trên Drive tương ứng với tài liệu có chế độ chia sẻ STUDENT_COPY 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 tệp đính kèm chỉ được điền sẵn nếu người dùng yêu cầu có quyền truy cập vào siêu dữ liệu đó. Các trường identifier và alternateLink luôn có sẵn, nhưng các trường khác (ví dụ: title) có thể không có.

Tệp đính kèm

Tệp đính kèm được thêm vào bài tập của học viên.

Khi tạo tệp đính kèm, bạn không thể đặt trường form.

Biểu diễn dưới dạng JSON 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
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:
driveFile

object (DriveFile)

Tệp đính kèm trên Google Drive.
youTubeVideo

object (YouTubeVideo)

Tệp đính kèm video trên YouTube.
form

object (Form)

Tệp đính kèm Google Biểu mẫu.

ShortAnswerSubmission

Bài làm 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
}
Trường
answer

string

Câu trả lời của học viên cho một câu hỏi trả lời ngắn.

MultipleChoiceSubmission

Bài tập của học viên cho câu hỏi trắc nghiệm.

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

string

Lựa chọn của học viên.

SubmissionHistory

Nhật ký của bản gửi. Thông tin này hiện bao gồm nhật ký về trạng thái và điểm số.

Biểu diễn dưới dạng JSON 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Trường
Trường nhóm type. Loại SubmissionHistory, có thể là một trong các loại StateHistory, GradeHistory. type chỉ có thể là một trong những trạng thái sau:
stateHistory

object (StateHistory)

Thông tin về nhật ký trạng thái của bản gửi (nếu có).
gradeHistory

object (GradeHistory)

Thông tin về nhật ký chấm điểm của bài tập đã nộp (nếu có).

StateHistory

Nhật ký của từng trạng thái mà nội dung này đã trải qua.

Biểu diễn dưới dạng JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Trường
state

enum (State)

Giai đoạn của quy trình công việc.
stateTimestamp

string (Timestamp format)

Thời điểm biểu mẫu được gửi chuyển sang trạng thái này.

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

string

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 có thể có của một bản gửi.

Enum
STATE_UNSPECIFIED Chưa chỉ định tiểu bang. Không bao giờ được trả về giá trị này.
CREATED Đã tạo bài tập.
TURNED_IN Học viên đã nộp một tài liệu được giao, 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, sau đó chọn "huỷ gửi" bài tập, nhờ đó học viên có lại 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, chỉ được dùng cho Câu hỏi, khi học viên chỉnh sửa câu trả lời của mình.

GradeHistory

Nhật ký của từng điểm số cho bài tập này.

Biểu diễn dưới dạng JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Trường
pointsEarned

number

Tử số của điểm tại thời điểm này trong nhật ký điểm của bài tập đã nộp.
maxPoints

number

Mẫu số của điểm tại thời điểm này trong nhật ký điểm của bài tập đã nộp.
gradeTimestamp

string (Timestamp format)

Thời điểm điểm của bài tập được thay đổi.

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

string

Giáo viên đã thay đổi điểm.
gradeChangeType

enum (GradeChangeType)

Loại thay đổi điểm tại thời điểm này trong nhật ký điểm của bài tập đã nộp.

GradeChangeType

Các loại thay đổi điểm có thể có.

Enum
UNKNOWN_GRADE_CHANGE_TYPE Chưa chỉ định loại thay đổi điểm. Không bao giờ được trả về giá trị này.
DRAFT_GRADE_POINTS_EARNED_CHANGE Thay đổi tử số của điểm nháp.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Thay đổi tử số của điểm được giao.
MAX_POINTS_CHANGE Thay đổi mẫu số của điểm.

Phương thức

get

 Trả lại bài tập đã gửi của học viên.

list

 Trả về danh sách bài tập đã nộp của học viên 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.

modifyAttachments

 Sửa đổi tệp đính kèm của bài nộp của học viên.

patch

 Cập nhật một hoặc nhiều trường của bài tập đã nộp của học viên.

reclaim

 Yêu cầu lại bài tập đã nộp của học viên thay mặt cho học viên sở hữu bài tập đó.

return

 Trả lại bài tập đã gửi của học viên.

turnIn

 Nộp bài tập của học viên.