Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem
tài liệu về tiện ích bổ sung để biết thêm thông tin.
Method: courses.courseWork.studentSubmissions.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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. Bạn có thể chỉ định - làm courseWorkId để đưa vào các bài nộp của học viên cho nhiều mục 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 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 được yêu cầu, hoặc do 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 đượ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 alias.
|
courseWorkId |
string
Giá trị nhận dạng của bài tập của học viên mà bạn muốn yêu cầu. Bạn có thể đặt giá trị này thành chuỗi cố định "-" để yêu cầu bài tập của học viên cho tất cả bài tậ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 của học viên được trả về chỉ dành cho những bài tập do học viên sở hữu với giá trị nhận dạng đã 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
- chuỗi cố định
"me", cho biết người dùng yêu cầu
|
states[] |
enum (SubmissionState)
Trạng thái gửi bài tập được yêu cầu. Nếu được chỉ định, bài nộp của học viên được trả về sẽ khớp với một trong các trạng thái bài nộp đã chỉ định.
|
late |
enum (LateValues)
Giá trị độ trễ được yêu cầu. Nếu được chỉ định, nội dung mà học viên gửi lại sẽ bị hạn chế theo giá trị được yêu cầu. Nếu không chỉ định, hệ thống sẽ trả về các nội dung gửi 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 hơn số kết quả đượ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 đã tạo ra 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 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.
|
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
Nội dung 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, bạn sẽ không nhận đượ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 gửi muộn giá trị. |
LATE_ONLY |
Trả về StudentSubmissions trong đó late là true. |
NOT_LATE_ONLY |
Trả về StudentSubmissions trong đó late là false. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: courses.courseWork.studentSubmissions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListStudentSubmissionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [LateValues](#LateValues)\n- [Try it!](#try-it)\n\nReturns a list of student submissions that the requester is permitted to view, factoring in the OAuth scopes of the request. `-` may be specified as the `courseWorkId` to include student submissions for multiple course work items.\n\nCourse students may only view their own work. Course teachers and domain administrators may view all student submissions.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n| `courseWorkId` | `string` Identifier of the student work to request. This may be set to the string literal `\"-\"` to request student work for all course work in the specified course. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string` Optional argument to restrict returned student work to those owned by the student with the specified identifier. The identifier can be one of the following: - the numeric identifier for the user - the email address of the user - the string literal `\"me\"`, indicating the requesting user |\n| `states[]` | `enum (`[SubmissionState](/workspace/classroom/reference/rest/v1/SubmissionState)`)` Requested submission states. If specified, returned student submissions match one of the specified submission states. |\n| `late` | `enum (`[LateValues](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions/list#LateValues)`)` Requested lateness value. If specified, returned student submissions are restricted by the requested value. If unspecified, submissions are returned regardless of `late` value. |\n| `pageSize` | `integer` Maximum number of items to return. Zero or unspecified indicates that the server may assign a maximum. The server may return fewer than the specified number of results. |\n| `pageToken` | `string` [nextPageToken](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions/list#body.ListStudentSubmissionsResponse.FIELDS.next_page_token) value returned from a previous `list` call, indicating that the subsequent page of results should be returned. The `list` request must be otherwise identical to the one that resulted in this token. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse when listing student submissions.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"studentSubmissions\": [ { object (/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `studentSubmissions[]` | `object (`[StudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission)`)` Student work that matches the request. |\n| `nextPageToken` | `string` Token identifying the next page of results to return. If empty, no further results are available. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students.readonly`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me.readonly`\n- `\n https://www.googleapis.com/auth/classroom.coursework.students`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nLateValues\n----------\n\nRestrictions on the late value of returned items.\n\n| Enums ||\n|---------------------------|-----------------------------------------------------|\n| `LATE_VALUES_UNSPECIFIED` | No restriction on submission late values specified. |\n| `LATE_ONLY` | Return StudentSubmissions where late is true. |\n| `NOT_LATE_ONLY` | Return StudentSubmissions where late is false. |"]]
