REST Resource: courses.courseWork.studentSubmissions

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 (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.
}
Các trường
courseId

string

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

Chỉ đọc.
courseWorkId

string

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

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à đ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

string

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

Chỉ đọc.
creationTime

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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ụ: "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.
late

boolean

Liệu bài tập này 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 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

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

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ớ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

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

Đ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 "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 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 "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à nội dung gửi này là dành cho.

Chỉ đọc.
associatedWithDeveloper

boolean

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 courseWork.create để biết thêm chi tiết.

Chỉ đọc.
submissionHistory[]

object (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

enum (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

object (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 studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Nội dung gửi khicourseWorkType là SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (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

string

Không bắt buộc. ID 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ì 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ấ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)
    }
  ]
}
Các 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ẻ ư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 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.
}
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

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
}
Các trường
answer

string

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

string

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 type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
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

object (StateHistory)

Thông tin về 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

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 (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Các trường
state

enum (State)

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

string (Timestamp format)

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ụ: "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 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 (GradeChangeType)
}
Các trường
pointsEarned

number

tử số của điểm tại thời điểm này trong lịch sử điểm đã nộp.
maxPoints

number

Mẫu số của điểm tại thời điểm này trong lịch sử điểm đã nộp.
gradeTimestamp

string (Timestamp format)

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ụ: "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)

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

get

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

list

 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.

modifyAttachments

 Sửa đổi các tệp đính kèm mà 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

 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 đó.

return

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

turnIn

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