Method: courses.courseWork.studentSubmissions.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. - có thể được chỉ định là courseWorkId để bao gồm bài làm mà học viên đã nộp cho nhiều mục của bài tập trong khoá học.

Học viên của khoá học chỉ có thể xem bài tập của chính mình. Giáo viên của khoá học và quản trị viên miền có thể xem tất cả bài làm của học viên.

Phương thức này trả về các mã lỗi sau:

  • PERMISSION_DENIED nếu người dùng yêu cầu không được phép truy cập khoá học hoặc bài tập trong khoá học mà họ yêu cầu, hoặc do có lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • NOT_FOUND nếu khoá học bạn yêu cầu không tồn tại.

Yêu cầu HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
courseId

string

Giá trị nhận dạng của khoá học. Giá trị nhận dạng này có thể là giá trị nhận dạng do Lớp học chỉ định hoặc alias.
courseWorkId

string

Giá trị nhận dạng bài tập của học viên cần yêu cầu. Bạn có thể đặt thuộc tính này thành giá trị cố định kiểu chuỗi "-" để yêu cầu học viên hoàn thành bài tập cho tất cả bài tập trong khoá học đã chỉ định.

Tham số truy vấn

Các tham số
userId

string

Đối số không bắt buộc để giới hạn bài tập được trả về của học viên với những bài tập mà học viên sở hữu bằng giá trị nhận dạng được chỉ định. Giá trị nhận dạng có thể là một trong những giá trị sau:

  • giá trị nhận dạng dạng số của người dùng
  • địa chỉ email của người dùng
  • giá trị cố định kiểu chuỗi "me", cho biết người dùng đưa ra yêu cầu
states[]

enum (SubmissionState)

Trạng thái của yêu cầu đã gửi. Nếu được chỉ định, bài nộp của học viên được trả sẽ khớp với một trong các trạng thái nộp đã chỉ định.
late

enum (LateValues)

Giá trị độ trễ đã yêu cầu. Nếu được chỉ định, bài tập mà học viên trả về sẽ bị hạn chế theo giá trị yêu cầu. Nếu không chỉ định, các lượt gửi sẽ được trả về bất kể giá trị late là gì.
pageSize

integer

Số lượng mục tối đa cần trả lại. Giá trị 0 hoặc không xác định cho biết máy chủ có thể chỉ định giá trị tối đa.

Máy chủ có thể trả về ít kết quả hơn số kết quả đã chỉ định.
pageToken

string

Giá trị nextPageToken được trả về từ lệnh gọi list trước đó, cho biết rằng trang kết quả tiếp theo sẽ được trả về.

Yêu cầu list phải giống với yêu cầu đã dẫn đến mã thông báo này.
previewVersion

enum (PreviewVersion)

Không bắt buộc. 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ử.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi khi liệt kê các bài làm mà học viên đã nộp.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Các trường
studentSubmissions[]

object (StudentSubmission)

Bài tập của học viên phù hợp với yêu cầu.
nextPageToken

string

Mã thông báo xác định trang kết quả tiếp theo cần trả về. Nếu trống, sẽ không có thêm kết quả nào.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

LateValues

Quy định hạn chế về giá trị quá hạn của các mặt hàng được trả lại.

Enum
LATE_VALUES_UNSPECIFIED Không có quy định hạn chế nào về việc gửi giá trị nộp muộn.
LATE_ONLY Trả bài nộp của học sinh nếu nộp muộn.
NOT_LATE_ONLY Trả lại những bài nộp của học viên mà nếu nộp muộn là không đúng.