REST Resource: courses.courseWork.studentSubmissions

منبع: ارسال دانشجو

ارسال دانشجو برای کار درسی

موارد StudentSubmission زمانی ایجاد می شود که یک مورد CourseWork ایجاد می شود.

ارسال‌های دانشجویی که هرگز به آنها دسترسی پیدا نکرده‌اند (یعنی با 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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
زمینه های
courseId

string

شناسه دوره

فقط خواندنی.

courseWorkId

string

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

فقط خواندنی.

id

string

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

فقط خواندنی.

userId

string

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

فقط خواندنی.

creationTime

string ( Timestamp format)

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

فقط خواندنی.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

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

فقط خواندنی.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

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 )

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

content زمینه اتحادیه مطالب ارسالی نوع خاص به مقدار course_work_type بستگی دارد. content فقط می تواند یکی از موارد زیر باشد:
assignmentSubmission

object ( AssignmentSubmission )

زمانی که courseWorkType ASSIGNMENT است، محتوا را ارسال کنید.

دانش آموزان می توانند این محتوا را با استفاده از studentSubmissions.modifyAttachments تغییر دهند.

shortAnswerSubmission

object ( ShortAnswerSubmission )

زمانی که دوره WorkType SHORT_ANSWER_QUESTION باشد، محتوا را ارسال کنید.

multipleChoiceSubmission

object ( MultipleChoiceSubmission )

زمانی که دوره WorkType MULTIPLE_CHOICE_QUESTION باشد، محتوا را ارسال کنید.

RubricGrade

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

نمایندگی JSON
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
زمینه های
criterionId

string

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

levelId

string

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

points

number

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

ارسال تکلیف

کار دانش آموز برای یک تکلیف.

نمایندگی JSON
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
زمینه های
attachments[]

object ( Attachment )

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

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

پیوست

پیوست به کار تکلیف دانش آموز اضافه شد.

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

نمایندگی JSON
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
زمینه های
attachment میدان اتحادیه . داده های پیوست attachment می تواند تنها یکی از موارد زیر باشد:
driveFile

object ( DriveFile )

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

youTubeVideo

object ( YouTubeVideo )

پیوست ویدیوی یوتیوب.

form

object ( Form )

پیوست Google Forms.

ارسال پاسخ کوتاه

کار دانش آموز برای یک سوال پاسخ کوتاه.

نمایندگی JSON
{
  "answer": string
}
زمینه های
answer

string

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

MultipleChoiceSubmission

کار دانش آموز برای یک سوال چند گزینه ای.

نمایندگی JSON
{
  "answer": string
}
زمینه های
answer

string

انتخاب دانشجو

تاریخچه ارسال

تاریخچه ارسال. این در حال حاضر شامل تاریخچه ایالت و درجه می شود.

نمایندگی JSON
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
زمینه های
type فیلد اتحادیه نوع SubmissionHistory، می تواند یکی از StateHistory، GradeHistory باشد. type می تواند تنها یکی از موارد زیر باشد:
stateHistory

object ( StateHistory )

اطلاعات تاریخچه وضعیت ارسال، در صورت وجود.

gradeHistory

object ( GradeHistory )

اطلاعات سابقه نمره از ارسال، در صورت وجود.

State History

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

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

enum ( State )

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

stateTimestamp

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

actorUserId

string

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

حالت

حالت های احتمالی برای ارسال ارسالی.

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

Grade History

تاریخچه هر نمره در این ارسال.

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

number

شمارنده نمره در این زمان در تاریخچه نمره ارسال.

maxPoints

number

مخرج نمره در این زمان در تاریخچه نمره ارسال.

gradeTimestamp

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

actorUserId

string

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

gradeChangeType

enum ( GradeChangeType )

نوع تغییر نمره در این زمان در تاریخچه نمره ارسال.

GradeChangeType

انواع تغییر درجه ممکن

Enums
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

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