REST Resource: courses.courseWork.studentSubmissions

منبع: StudentSubmission

ارسال محصل برای کار کلاسی.

وقتی مورد CourseWork ایجاد می‌شود، موارد StudentSubmission تولید می‌شوند.

تکالیف ارسال‌شده محصلین که هرگز به آن‌ها دسترسی پیدا نشده است (یعنی با state = NEW) ممکن است زمان ایجاد یا زمان به‌روزرسانی نداشته باشند.

نمایش JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
فیلدها
courseId

string

شناسه دوره.

فقط خواندنی.
courseWorkId

string

شناسه مربوط به تکالیف درسی که این مورد با آن مطابقت دارد.

فقط خواندنی.
id

string

شناسه اختصاص‌داده‌شده Classroom برای ارسال محصل. این مورد در میان ارسال‌های مربوط به کار کلاسی مربوطه منحصربه‌فرد است.

فقط خواندنی.
userId

string

شناسه محصلی که مالک این مورد ارسالی است.

فقط خواندنی.
creationTime

string (Timestamp format)

زمان ایجاد این مورد ارسالی. اگر دانش‌آموز به این مورد دسترسی نداشته باشد، ممکن است این مقدار تنظیم نشده باشد.

فقط خواندنی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

زمان آخرین به‌روزرسانی این مورد ارسالی. اگر دانش‌آموز به این مورد دسترسی نداشته باشد، ممکن است این مقدار تنظیم نشده باشد.

فقط خواندنی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

وضعیت این مورد ارسالی.

فقط خواندنی.
late

boolean

اینکه این مورد ارسالی دیر ارسال شده است یا نه.

فقط خواندنی.
draftGrade

number

نمره معلق اختیاری. اگر تنظیم نشده باشد، هیچ نمره‌ای تنظیم نشده است. این مقدار باید غیرمنفی باشد. مقادیر اعشاری (یعنی غیرعدد صحیح) مجاز است، اما به دو رقم اعشار گرد می‌شود.

این فقط برای معلمان دوره قابل‌مشاهده و اصلاح است.
assignedGrade

number

نمره اختیاری. اگر تنظیم نشده باشد، هیچ نمره‌ای تنظیم نشده است. این مقدار باید غیرمنفی باشد. مقادیر اعشاری (یعنی غیرعدد صحیح) مجاز است، اما به دو رقم اعشار گرد می‌شود.

فقط معلمان دوره می‌توانند این مورد را تغییر دهند.
rubricId

string

فقط خروجی. شناسه سیستم نمره‌دهی که درحال‌حاضر به این کار کلاسی پیوست شده است و برای نمره‌دهی به این تکلیف محصل استفاده می‌شود.

اگر سنجه ارزیابی وجود نداشته باشد، این شناسه خالی است. این شناسه نشان‌دهنده راهنمای نمره‌دهی فعال فعلی است؛ اگر معلمان راهنمای نمره‌دهی را حذف و دوباره ایجاد کنند، این شناسه تغییر می‌کند.

فقط خواندنی.

draftRubricGrades

map (key: string, value: object (RubricGrade))

نمره‌های سیستم نمره‌دهی معلقه براساس معیارهای سیستم نمره‌دهی.

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

فقط خواندنی.

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

نمره‌های سیستم نمره‌دهی براساس «معیارهای» سیستم نمره‌دهی اختصاص داده شده است.

اگر هیچ سیستم نمره‌دهی‌ای به این کار کلاسی پیوست نشده باشد یا اگر سیستم نمره‌دهی پیوست شده باشد اما هیچ نمره‌ای برای هیچ‌کدام از «معیارها» تنظیم نشده باشد، این نقشه خالی است. ورودی‌ها فقط برای نمره‌هایی که تنظیم شده‌اند درج می‌شود. کلید: شناسه معیار سیستم نمره‌دهی.

فقط خواندنی.

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

نوع کار کلاسی که این ارسال برای آن است.

فقط خواندنی.
associatedWithDeveloper

boolean

اینکه این تکلیف ارسال‌شده دانش‌آموز با پروژه «کنسول توسعه‌دهنده» که درخواست را ایجاد می‌کند مرتبط است یا نه.

برای جزئیات بیشتر، به courseWork.create بروید.

فقط خواندنی.
submissionHistory[]

object (SubmissionHistory)

سابقه ارسال (شامل سابقه وضعیت و نمره).

فقط خواندنی.
previewVersion

enum (PreviewVersion)

فقط خروجی. نسخه پیش‌نمایش میانای برنامه‌سازی کاربردی. این مورد باید تنظیم شود تا بتوان به قابلیت‌های جدید میانای برنامه‌سازی کاربردی که برای توسعه‌دهندگان در «برنامه پیش‌نمایش» دردسترس قرار گرفته است دسترسی پیدا کرد.
محتوای ارسالی. نوع خاص به مقدار course_work_type بستگی دارد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
assignmentSubmission

object (AssignmentSubmission)

محتوای ارسالی وقتی courseWorkType از نوع ASSIGNMENT باشد.

محصلان می‌توانند این محتوا را بااستفاده از studentSubmissions.modifyAttachments اصلاح کنند.
shortAnswerSubmission

object (ShortAnswerSubmission)

محتوای ارسالی وقتی courseWorkType از نوع SHORT_ANSWER_QUESTION باشد.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

محتوای ارسال‌شده وقتی courseWorkType از نوع MULTIPLE_CHOICE_QUESTION باشد.
پایان فیلدهای متقابلاً انحصاری.

RubricGrade

نمره سیستم نمره‌دهی برای تکلیف ارسالی محصل تنظیم شده است. حداکثر یک ورودی برای هر معیار ارزیابی وجود دارد.

نمایش JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
فیلدها
criterionId

string

اختیاری. شناسه معیار.
levelId

string

اختیاری. شناسه سطح اختیاری سطح انتخاب‌شده. اگر خالی باشد، هیچ سطحی انتخاب نشده است.
points

number

اختیاری. امتیازهای اختیاری اختصاص‌داده‌شده برای این معیار، معمولاً براساس سطح. سطح‌ها ممکن است امتیاز داشته باشند یا نداشته باشند. اگر تنظیم نشده باشد، هیچ امتیازی برای این معیار تنظیم نشده است.

AssignmentSubmission

کار محصل برای تکلیف.

نمایش JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
فیلدها
attachments[]

object (Attachment)

پیوست‌هایی که محصل اضافه کرده است. اگر دانش‌آموز به تکلیف در Classroom دسترسی نداشته باشد، ممکن است فایل‌های Drive که با مطالب دارای حالت هم‌رسانی STUDENT_COPY مطابقت دارند هنوز وجود نداشته باشند.

برخی‌از فراداده‌های پیوست فقط درصورتی تکمیل می‌شود که کاربر درخواست‌کننده اجازه دسترسی به آن را داشته باشد. فیلدهای Identifier و alternateLink همیشه دردسترس هستند، اما فیلدهای دیگر (برای مثال، title) ممکن است دردسترس نباشند.

پیوست

پیوست به کار تکلیف محصل اضافه شد.

هنگام ایجاد پیوست، تنظیم فیلد form پشتیبانی نمی‌شود.

نمایش JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
فیلدها
داده‌های پیوست. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
driveFile

object (DriveFile)

پیوست فایل Google Drive.
youTubeVideo

object (YouTubeVideo)

پیوست ویدیو YouTube.
form

object (Form)

پیوست «فرم‌نگار Google».
پایان فیلدهای متقابلاً انحصاری.

ShortAnswerSubmission

کار دانش‌آموز برای سؤال جواب‌کوتاه.

نمایش JSON 
{
  "answer": string
}
فیلدها
answer

string

پاسخ دانش‌آموز به سؤال جواب‌کوتاه.

MultipleChoiceSubmission

کار محصل برای سؤال چندگزینه‌ای.

نمایش JSON 
{
  "answer": string
}
فیلدها
answer

string

انتخاب محصل.

SubmissionHistory

سابقه ارسال. این اطلاعات درحال‌حاضر شامل سابقه وضعیت و نمره می‌شود.

نمایش JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
فیلدها
نوع SubmissionHistory، می‌تواند یکی از StateHistory،‏ GradeHistory باشد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
stateHistory

object (StateHistory)

اطلاعات سابقه وضعیت ارسال، درصورت وجود.
gradeHistory

object (GradeHistory)

اطلاعات سابقه نمره تکلیف، درصورت وجود.
پایان فیلدهای متقابلاً انحصاری.

StateHistory

سابقه هر وضعیتی که این ارسال در آن بوده است.

نمایش JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
فیلدها
state

enum (State)

مرحله خط لوله گردش کار.
stateTimestamp

string (Timestamp format)

زمانی که ارسال وارد این وضعیت شد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
actorUserId

string

معلم یا دانش‌آموزی که تغییر را ایجاد کرده است.

ایالت

وضعیت‌های ممکن برای ارسال.

شمارشی‌ها
STATE_UNSPECIFIED هیچ استانی مشخص نشده است. این نباید هرگز برگردانده شود.
CREATED «مورد ارسالی» ایجاد شد.
TURNED_IN دانش‌آموز سند واگذارشده‌ای را تحویل داده است که ممکن است الگو باشد یا نباشد.
RETURNED معلم سند واگذارشده را به محصل برگردانده است.
RECLAIMED_BY_STUDENT دانش‌آموز سند واگذارشده را تحویل می‌دهد و سپس تصمیم می‌گیرد تکلیف را «لغو ارسال» کند، که این کار دوباره کنترل را به‌عنوان مالک به دانش‌آموز می‌دهد.
STUDENT_EDITED_AFTER_TURN_IN محصل پس‌از ارسال تکلیف، آن را ویرایش کرده است. درحال‌حاضر، فقط برای «سؤالات» استفاده می‌شود، وقتی دانش‌آموز پاسخش را ویرایش می‌کند.

GradeHistory

سابقه هر نمره در این تکلیف ارسالی.

نمایش JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
فیلدها
pointsEarned

number

صورت نمره در این زمان در سابقه نمره تکلیف.
maxPoints

number

مخرج نمره در این زمان در سابقه نمره تکلیف ارسالی.
gradeTimestamp

string (Timestamp format)

وقتی نمره تکلیف ارسالی تغییر کرده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
actorUserId

string

معلمی که نمره را تغییر داده است.
gradeChangeType

enum (GradeChangeType)

نوع تغییر نمره در این زمان در سابقه نمره تکلیف.

GradeChangeType

انواع ممکن تغییر نمره.

شمارشی‌ها
UNKNOWN_GRADE_CHANGE_TYPE نوع تغییر نمره مشخص نشده است. این نباید هرگز برگردانده شود.
DRAFT_GRADE_POINTS_EARNED_CHANGE تغییر در صورت کسر نمره پیش‌نویس.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE تغییر در صورت کسر نمره اختصاص‌داده‌شده.
MAX_POINTS_CHANGE تغییر در مخرج نمره.

روش‌ها

get

 تکلیف محصل را برمی‌گرداند.

list

 فهرستی از موارد ارسالی محصل را که درخواست‌کننده مجاز به مشاهده آن‌ها است، با درنظر گرفتن دامنه‌های OAuth درخواست، برمی‌گرداند.

modifyAttachments

 پیوست‌های ارسال محصل را اصلاح می‌کند.

patch

 یک یا چند فیلد از تکلیف ارسالی محصل را به‌روز می‌کند.

reclaim

 واگذاری دانش‌آموز را ازطرف دانش‌آموز مالک آن پس می‌گیرد.

return

 تکلیف محصل را برمی‌گرداند.

turnIn

 تکلیف ارسال‌شده دانش‌آموز را تحویل می‌دهد.