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.
}
فیلدها
course Id

string

شناسه دوره

فقط خواندنی

course Work Id

string

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

فقط خواندنی

id

string

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

فقط خواندنی

user Id

string

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

فقط خواندنی

creation Time

string ( Timestamp format)

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

فقط خواندنی

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

update Time

string ( Timestamp format)

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

فقط خواندنی

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

state

enum ( SubmissionState )

وضعیت این ارسال

فقط خواندنی

late

boolean

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

فقط خواندنی

draft Grade

number

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

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

assigned Grade

number

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

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

rubric Id

string

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

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

فقط خواندنی

draft Rubric Grades

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

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

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

فقط خواندنی

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

assigned Rubric Grades

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

نمرات روبریک بر اساس معیارهای روبریک اختصاص داده شد.

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

فقط خواندنی

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

course Work Type

enum ( CourseWorkType )

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

فقط خواندنی

associated With Developer

boolean

آیا این ارسال دانشجو با پروژه کنسول برنامه‌نویس که درخواست را ارائه می‌کند مرتبط است یا خیر.

برای جزئیات بیشتر به courseWork.create مراجعه کنید.

فقط خواندنی

submission History[]

object ( SubmissionHistory )

تاریخچه ارسال (شامل تاریخچه ایالت و درجه).

فقط خواندنی

preview Version

enum ( PreviewVersion )

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

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

object ( AssignmentSubmission )

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

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

short Answer Submission

object ( ShortAnswerSubmission )

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

multiple Choice Submission

object ( MultipleChoiceSubmission )

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

RubricGrade

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

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

string

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

level Id

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 می تواند تنها یکی از موارد زیر باشد:
drive File

object ( DriveFile )

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

you Tube Video

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 می تواند تنها یکی از موارد زیر باشد:
state History

object ( StateHistory )

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

grade History

object ( GradeHistory )

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

State History

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

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

enum ( State )

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

state Timestamp

string ( Timestamp format)

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

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

actor User Id

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)
}
فیلدها
points Earned

number

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

max Points

number

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

grade Timestamp

string ( Timestamp format)

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

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

actor User Id

string

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

grade Change Type

enum ( GradeChangeType )

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

GradeChangeType

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

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

روش ها

get

 ارسالی دانشجو را برمی گرداند.

list

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

modify Attachments

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

patch

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

reclaim

 یک ارسال دانشجویی را از طرف دانش‌آموزی که مالک آن است، پس می‌گیرد.

return

 ارسالی دانشجو را برمی گرداند.

turn In

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