تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
Method: courses.courseWork.studentSubmissions.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرِض هذه الدالة قائمة بالمهام التي أرسلها الطلاب ويُسمح لمقدّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب. يمكن تحديد - على أنّه courseWorkId لتضمين العناصر التي أرسلها الطلاب لعناصر متعددة في عمل الدورة التدريبية.
يمكن لطلاب الدورة التدريبية الاطّلاع على أعمالهم فقط. يمكن لمعلّمي الدورة التدريبية ومشرفي النطاق الاطّلاع على جميع المهام التي أرسلها الطلاب.
تُرجع هذه الطريقة رموز الأخطاء التالية:
PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم المُقدّم للطلب بالوصول إلى الدورة التدريبية أو العمل المطلوب، أو بسبب أخطاء في الوصولINVALID_ARGUMENT إذا كان الطلب غير صالحNOT_FOUND إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.
طلب HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
courseId |
string
معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف هو المعرّف الذي تحدّده Classroom أو alias.
|
courseWorkId |
string
معرّف عمل الطالب المطلوب. يمكن ضبط هذا الخيار على السلسلة الثابتة "-" لطلب عمل الطالب لجميع أعمال الدورة التدريبية في الدورة التدريبية المحدّدة.
|
مَعلمات طلب البحث
| المعلمات |
userId |
string
وسيطة اختيارية لتقييد أعمال الطلاب التي يتم إرجاعها بتلك التي يملكها الطالب الذي يحمل المعرّف المحدّد. يمكن أن يكون المعرّف واحدًا مما يلي:
- المعرّف الرقمي للمستخدم
- عنوان البريد الإلكتروني للمستخدم
- السلسلة الحرفية
"me" التي تشير إلى المستخدم الذي يقدّم الطلب
|
states[] |
enum (SubmissionState)
حالات الإرسال المطلوبة إذا تم تحديدها، تتطابق العينات التي أرسلها الطلاب والتي تم إرجاعها مع إحدى حالات الإرسال المحدّدة.
|
late |
enum (LateValues)
قيمة التأخير المطلوبة. إذا تم تحديد قيمة، يتم تقييد المحتوى الذي أرسله الطلاب والذي تم إرجاعه بالقيمة المطلوبة. إذا لم يتم تحديد قيمة، يتم عرض الطلبات المقدَّمة بغض النظر عن قيمة late.
|
pageSize |
integer
الحد الأقصى لعدد العناصر التي سيتم عرضها تشير القيمة صفر أو غير محدّد إلى أنّ الخادم قد يحدّد حدًا أقصى. قد يعرض الخادم عددًا أقل من العدد المحدّد من النتائج.
|
pageToken |
string
قيمة nextPageToken التي تم إرجاعها من طلب list سابق، ما يشير إلى أنّه يجب عرض الصفحة التالية من النتائج. يجب أن يكون طلب list مطابقًا للطلب الذي أدّى إلى إنشاء هذا الرمز المميّز.
|
previewVersion |
enum (PreviewVersion)
اختياريّ. إصدار المعاينة لواجهة برمجة التطبيقات. يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الردّ عند إدراج المحتوى الذي أرسله الطلاب
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"studentSubmissions": [
{
object (StudentSubmission)
}
],
"nextPageToken": string
} |
| الحقول |
studentSubmissions[] |
object (StudentSubmission)
عمل الطالب الذي يتطابق مع الطلب
|
nextPageToken |
string
رمز مميز يحدِّد الصفحة التالية من النتائج التي سيتم عرضها. إذا كان الحقل فارغًا، لن تتوفّر أي نتائج أخرى.
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
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
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
LateValues
قيود على قيمة السلع المُسترَدة بعد انقضاء فترة السماح
| عمليات التعداد |
LATE_VALUES_UNSPECIFIED |
لم يتم تحديد أي قيود على القيم المتأخرة لإرسال العينة. |
LATE_ONLY |
عرض StudentSubmissions حيث يكون الحقل late صحيحًا |
NOT_LATE_ONLY |
عرض StudentSubmissions حيث يكون الحقل late خطأ |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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. |"]]
