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 Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 )

اختیاری. نسخه پیش نمایش API. این باید برای دسترسی به قابلیت‌های API جدیدی که در برنامه پیش‌نمایش برای توسعه‌دهندگان در دسترس است، تنظیم شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ در هنگام فهرست کردن مطالب ارسالی دانشجو.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی 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

محدودیت در ارزش دیرکرد اقلام برگشتی.

Enums
LATE_VALUES_UNSPECIFIED هیچ محدودیتی برای مقادیر تاخیری ارسال مشخص نشده است.
LATE_ONLY ارسال‌های دانشجو را در جایی که تأخیر درست است، برگردانید.
NOT_LATE_ONLY در جایی که تأخیر نادرست است، ارسال‌های دانشجویی را برگردانید.