REST Resource: courses.courseWork.studentSubmissions

Tài nguyên: StudentSubmission

Bài làm của học viên trong khoá học.

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

Bài nộp của học viên chưa từng được truy cập (tức là có 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 (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ó thể đọc.
courseWorkId

string

Giá trị nhận dạng cho bài tập trong khoá học tương ứng.

Chỉ có thể đọc.
id

string

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à bài tập duy nhất trong số các bài tập nộp cho bài tập liên quan trong khoá học.

Chỉ có thể đọ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ó thể đọc.
creationTime

string (Timestamp format)

Thời gian tạo nội dung gửi này. Bạn có thể không đặt giá trị này nếu học viên chưa truy cập vào mục này.

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)

Thời gian cập nhật gần đây nhất của nội dung gửi này. Bạn có thể không đặt giá trị này nếu học viên chưa truy cập vào mục này.

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

enum (SubmissionState)

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

Chỉ có thể đọc.
late

boolean

Bài tập này có bị nộp muộn hay không.

Chỉ có thể đọ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à số không âm. Bạn có thể sử dụng giá trị thập phân (tức là giá trị không phải số nguyên) nhưng phải làm tròn đến hai chữ số thập phân.

Chỉ giáo viên của khoá học mới thấy và có thể 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à số không âm. Bạn có thể sử dụng giá trị thập phân (tức là giá trị không phải số nguyên) nhưng phải 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 thông tin này.
rubricId

string

Chỉ có đầu ra. Giá trị 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 trong khoá học này và dùng để chấm điểm bài nộp của học viên.

Mã này sẽ trống nếu không có thang điểm. Mã nhận dạng này phản ánh điểm chuẩn đang hoạt động; mã nhận dạng này sẽ thay đổi nếu giáo viên xoá và tạo lại điểm chuẩn.

Chỉ có thể đọc.

draftRubricGrades

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

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

Bản đồ này sẽ trống nếu không có tiêu chí đính kèm vào bài tập này hoặc nếu có tiêu chí đính kèm nhưng chưa có điểm nào được đặt theo tiêu chí. Mục nhập chỉ được điền sẵn cho những điểm đã được đặt. Khoá: Mã tiêu chí của thang điểm.

Chỉ có thể đọ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 số theo thang điểm được chỉ định dựa trên Tiêu chí của thang đ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 nhưng bạn chưa đặt điểm cho bất kỳ tiêu chí nào. Mục nhập chỉ được điền sẵn cho những điểm đã được đặt. Khoá: Mã tiêu chí của thang điểm.

Chỉ có thể đọ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 trong khoá học mà bài nộp này dành cho.

Chỉ có thể đọc.
associatedWithDeveloper

boolean

Liệu nội dung mà học viên gửi 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.
submissionHistory[]

object (SubmissionHistory)

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

Chỉ có thể đọ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 tính năng API mới được cung cấp cho nhà phát triển trong Chương trình xem trước.
Trường hợp hợp nhất 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 loại sau:
assignmentSubmission

object (AssignmentSubmission)

Nội dung gửi 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 nộp khi courseWorkType là SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Nội dung gửi khi courseWorkType là MULTIPLE_CHOICE_QUESTION.

RubricGrade

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

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à không có cấp nào được chọn.
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 giá trị, 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.

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

object (Attachment)

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ẻ là 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 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 đính kèm đó. 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 được đặ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 hợp hợp nhất attachment. Dữ liệu tệp đính kèm. attachment chỉ có thể là một trong những loạ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 trên 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 dạng 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
}
Trường
answer

string

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

SubmissionHistory

Nhật ký gửi. Hiện tại, phần này bao gồm trạng thái và nhật ký điểm.

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 hợp hợp nhất type. Loại của SubmissionHistory, có thể là một trong các loại StateHistory, GradeHistory. type chỉ có thể là một trong những loại sau:
stateHistory

object (StateHistory)

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

object (GradeHistory)

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

StateHistory

Nhật ký về từng trạng thái mà nội dung gửi 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 quy trình công việc.
stateTimestamp

string (Timestamp format)

Thời điểm nội dung gửi vào trạng thái này.

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".
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ài tập đã nộp.

Enum
STATE_UNSPECIFIED Chưa chỉ định trạng thái. Bạn không được trả về giá trị này.
CREATED Đã tạo nội dung gửi.
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 phải là mẫu.
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, để học viên có quyền kiểm soát lại 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 Câu hỏi sử dụng khi học viên chỉnh sửa câu trả lời.

GradeHistory

Nhật ký của từng điểm số trên 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 (GradeChangeType)
}
Trường
pointsEarned

number

Mẫu số của điểm tại thời điểm này trong nhật ký điểm bài 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 bài nộp.
gradeTimestamp

string (Timestamp format)

Thời điểm điểm của bài nộp thay đổi.

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".
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 bài nộp.

GradeChangeType

Các loại thay đổi điểm có thể xảy ra.

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

Phương thức

get

 Trả về bài nộp của học viên.

list

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

reclaim

 Thay mặt học viên sở hữu bài nộp, lấy lại bài nộp của học viên.

return

 Trả về bài nộp của học viên.

turnIn

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