Method: courses.courseWork.studentSubmissions.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. Bạn có thể chỉ định dấu gạch ngang (-) làm courseWorkId để đưa bài tập đã nộp của học viên vào nhiều mục bài tập trên lớp.

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

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 vào khoá học hoặc bài tập trên lớp được yêu cầu, hoặc đối với lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu sai định dạng.
  • NOT_FOUND nếu khoá học được 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

Thông 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 một alias.
courseWorkId

string

Mã nhận dạng của bài tập mà bạn muốn yêu cầu. Bạn có thể đặt giá trị này thành chuỗi ký tự "-" để yêu cầu bài tập của học viên cho tất cả bài tập trên lớp trong khoá học đã chỉ định.

Tham số truy vấn

Thông số
userId

string

Đối số không bắt buộc để hạn chế bài tập đã trả lại của học viên đối với những bài tập thuộc sở hữu của học viên có 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ố cho người dùng
  • địa chỉ email của người dùng
  • giá trị cố định của chuỗi "me", cho biết người dùng yêu cầu
states[]

enum (SubmissionState)

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

enum (LateValues)

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

integer

Số lượng mục tối đa cần trả về. 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ố lượng được 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 hệt 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 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ử.

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ê bài nộp của học viên.

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
}
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, tức là không có kết quả nào khác.

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

Hạn chế về giá trị trả lại muộn của các mặt hàng.

Enum
LATE_VALUES_UNSPECIFIED Không có quy định hạn chế nào về việc chỉ định giá trị muộn khi gửi.
LATE_ONLY Trả về StudentSubmissions trong đó late là true.
NOT_LATE_ONLY Trả về StudentSubmissions trong đó late là false.