REST Resource: courses.courseWork.studentSubmissions

Tài nguyên: Nội dung do học viên gửi

Nội dung học viên đã nộp để làm 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 tập mà học viên chưa từng 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 (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 của bài tập trong khoá học tương ứng với giá trị này.

Chỉ có thể đọc.
id

string

Mã nhận dạng do Lớp học chỉ định cho bài tập học viên nộp. Đâ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ó thể đọc.
userId

string

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

Chỉ có thể đọc.
creationTime

string (Timestamp format)

Thời gian tạo của lần 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ó thể đọc.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. 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 lần 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ó thể đọc.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Trạng thái của nội dung gửi này.

Chỉ có thể đọc.
late

boolean

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

Chỉ giáo viên của khoá học mới xem được và có thể chỉnh sửa.
assignedGrade

number

Đ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. Bạn có thể sử dụng giá trị thập phân (tức là không phải số nguyên), nhưng 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 nội dung 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ới bài tập của khoá học này và dùng để chấm điểm bài tập mà học viên đã nộp.

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; nó sẽ thay đổi nếu giáo viên xoá và tạo lại tiêu chí chấm điểm.

Chỉ có thể đọc.

draftRubricGrades

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

Đang chờ chấm điểm theo tiêu chí chấm điểm dựa trên các tiêu chí của bộ tiêu chí.

Bản đồ này trống nếu không có tiêu chí chấm điểm được đính kèm với bài tập khóa học này hoặc nếu 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. Dữ liệu đầu vào chỉ được điền sẵn cho điểm đã được thiết lập. Khoá: ID tiêu chí của tiêu chí chấm đ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))

Đã chỉ định điểm theo tiêu chí chấm điểm dựa trên Tiêu chí của bộ tiêu chí.

Bản đồ này trống nếu không có tiêu chí chấm điểm được đính kèm với bài tập khóa học này hoặc nếu tiêu chí chấm điểm được đính kèm nhưng chưa đặt điểm cho bất kỳ Tiêu chí nào. Dữ liệu đầu vào chỉ được điền sẵn cho điểm đã được thiết lập. Khoá: ID tiêu chí của tiêu chí chấm đ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 khoá học mà bài nộp này dành.

Chỉ có thể đọc.
associatedWithDeveloper

boolean

Liệu nội dung mà học viên gửi có liên kết với dự án tạo yêu cầu trong Developer Console 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ý nộp bài (bao gồm cả nhật ký tiểu bang 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 thuộc tính 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 kết hợp 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

object (AssignmentSubmission)

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

object (MultipleChoiceSubmission)

Nội dung gửi khicourseWorkType là MULTIPLE_CHOOSE_QUESTION.

RubricGrade

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

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 thì chưa 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 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 (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ẻ Nếu học viên chưa truy cập vào bài tập trong Lớp học, thì các tệp trên Drive có thể chưa tồn tại.

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 siêu dữ liệu đó. Các trường Nhận dạng và AlternativeLink luôn có sẵn, nhưng các trường khác (ví dụ: tiêu đề) 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 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 kết hợp 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

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 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
}
Trường
answer

string

Phản hồ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 đối với 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 nội dung gửi. Dữ liệu này hiện bao gồm nhật ký tiểu bang và đ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 kết hợp type. Loại Lịch sử nộp bài, có thể là một trong các Lịch sử Trạng thái, Lịch sử Điểm. type chỉ có thể là một trong những trạng thái sau đây:
stateHistory

object (StateHistory)

Thông tin về lịch sử 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 tập, nếu có.

StateHistory

Lịch sử của mỗi trạng thái mà nội dung này đã xuất hiện.

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 làm việc.
stateTimestamp

string (Timestamp format)

Khi nội dung bạn gửi chuyển sang trạng thái này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. 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ể áp dụng cho nội dung gửi.

Enum
STATE_UNSPECIFIED Chưa chỉ định tiểu bang nào. Bạn không được trả về giá trị này.
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à hoặc không phải là mẫu.
RETURNED Giáo viên đã trả lại tài liệu đã 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, cấp lại cho học viên 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. Tính năng này hiện chỉ được dùng trong mục 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 (GradeChangeType)
}
Trường
pointsEarned

number

tử số của điểm hiện tại trong nhật ký điểm nộp bài.
maxPoints

number

Mẫu số của điểm hiện tại trong nhật ký điểm đã nộp.
gradeTimestamp

string (Timestamp format)

Khi điểm của bài tập đã nộp thay đổi.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. 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)

Hình thức thay đổi điểm hiện tại trong nhật ký điểm đã 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. Bạn không được trả về giá trị này.
DRAFT_GRADE_POINTS_EARNED_CHANGE Thay đổi tử số của điểm không chính thức.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Thay đổi tử số của điểm đã chỉ định.
MAX_POINTS_CHANGE Sự thay đổi mẫu số của điểm.

Phương thức

get

 Trả về bài tập học viên đã nộp.

list

 Trả về danh sách bài tập học viên đã nộp mà người yêu cầu được phép xem, có xét đến phạm vi OAuth của yêu cầu.

modifyAttachments

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

patch

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

reclaim

 Thay mặt học viên sở hữu bài tập mà học viên đã nộp.

return

 Trả về bài tập học viên đã nộp.

turnIn

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