REST Resource: courses.courseWork

منبع: دوره‌های آموزشی

کار درسی که توسط معلم برای دانشجویان دوره ایجاد شده است.

نمایش JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
فیلدها
courseId

string

شناسه دوره.

فقط خواندنی.

id

string

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

فقط خواندنی.

title

string

عنوان این دوره آموزشی. عنوان باید یک رشته معتبر UTF-8 باشد که شامل ۱ تا ۳۰۰۰ کاراکتر باشد.

description

string

توضیحات اختیاری برای این دوره آموزشی. در صورت تنظیم، توضیحات باید یک رشته معتبر UTF-8 باشد که بیش از 30،000 کاراکتر نداشته باشد.

materials[]

object ( Material )

مواد اضافی.

محتوای دوره‌های آموزشی نباید بیش از 20 مورد باشد.

state

enum ( CourseWorkState )

وضعیت کار این دوره. اگر مشخص نشده باشد، حالت پیش‌فرض DRAFT است.

creationTime

string ( Timestamp format)

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

فقط خواندنی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

dueDate

object ( Date )

تاریخ اختیاری، به UTC، که در آن باید تکالیف این درس را ارائه دهید. در صورت مشخص بودن dueTime ، این تاریخ باید مشخص شود.

dueTime

object ( TimeOfDay )

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

scheduledTime

string ( Timestamp format)

مهر زمانی اختیاری که قرار است این کار درسی منتشر شود.

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

maxPoints

number

حداکثر نمره برای این کار درسی. اگر صفر یا نامشخص باشد، این تکلیف بدون نمره در نظر گرفته می‌شود. این باید یک مقدار صحیح غیر منفی باشد.

workType

enum ( CourseWorkType )

نوع کار این دوره.

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

associatedWithDeveloper

boolean

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

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

فقط خواندنی.

assigneeMode

enum ( AssigneeMode )

حالت واگذاری تکالیف. اگر مشخص نشود، مقدار پیش‌فرض ALL_STUDENTS است.

individualStudentsOptions

object ( IndividualStudentsOptions )

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

submissionModificationMode

enum ( SubmissionModificationMode )

تنظیم برای تعیین زمان مجاز تغییر مطالب ارسالی توسط دانشجویان. در صورت عدم تعیین مقدار، مقدار پیش‌فرض MODIFIABLE_UNTIL_TURNED_IN است.

creatorUserId

string

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

فقط خواندنی.

topicId

string

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

gradeCategory

object ( GradeCategory )

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

فقط خواندنی.

previewVersion

enum ( PreviewVersion )

فقط خروجی. نسخه پیش‌نمایش API مورد استفاده برای بازیابی این منبع.

learningGoals[]

object ( LearningGoal )

اختیاری.

ارجاع به هرگونه هدف یادگیری پیوست شده به این دوره آموزشی. این فیلد فقط در صورتی پر می‌شود که PreviewVersion مناسب تنظیم شده باشد. CourseWork می‌تواند حداکثر 10 هدف یادگیری داشته باشد.

details فیلد اتحادیه. جزئیات اضافی که مختص یک نوع کار درسی هستند. details می‌توانند فقط یکی از موارد زیر باشند:
assignment

object ( Assignment )

جزئیات تکلیف. این فقط زمانی پر می‌شود که workType ASSIGNMENT باشد.

فقط خواندنی.

multipleChoiceQuestion

object ( MultipleChoiceQuestion )

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

gradingPeriodId

string

شناسه دوره نمره‌دهی مرتبط با دوره آموزشی.

  • در هنگام ایجاد، اگر مشخص نشده باشد، شناسه دوره نمره‌دهی بر اساس dueDate (یا scheduledTime در صورت عدم تنظیم dueDate ) تنظیم خواهد شد.
  • برای نشان دادن عدم ارتباط با هیچ دوره نمره‌دهی، این فیلد را با یک رشته خالی ("") مقداردهی کنید.
  • در صورت مشخص شدن، باید با شناسه دوره نمره‌دهی موجود در دوره مطابقت داشته باشد.

دوره WorkState

البته حالت‌های ممکن کار می‌کنند.

انوم‌ها
COURSE_WORK_STATE_UNSPECIFIED هیچ حالتی مشخص نشده است. این هرگز بازگردانده نمی‌شود.
PUBLISHED وضعیت برای اثری که منتشر شده است. این وضعیت پیش‌فرض است.
DRAFT وضعیت کاری که هنوز منتشر نشده است. کاری که در این وضعیت باشد فقط برای مدرسان دوره و مدیران دامنه قابل مشاهده است.
DELETED وضعیت مربوط به اثری که منتشر شده بود اما اکنون حذف شده است. اثری که در این حالت قرار دارد فقط برای مدرسان دوره و مدیران دامنه قابل مشاهده است. اثری که در این حالت قرار دارد پس از مدتی حذف می‌شود.

حالت اصلاح ارسال

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

انوم‌ها
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED هیچ حالت اصلاحی مشخص نشده است. این هرگز بازگردانده نمی‌شود.
MODIFIABLE_UNTIL_TURNED_IN آثار ارسالی را می‌توان قبل از تحویل اصلاح کرد.
MODIFIABLE مطالب ارسالی را می‌توان در هر زمانی اصلاح کرد.

تکلیف

توضیحات تکمیلی برای تکالیف.

نمایش JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
فیلدها
studentWorkFolder

object ( DriveFolder )

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

سوال چندگزینه‌ای

جزئیات بیشتر برای سوالات چند گزینه ای.

نمایش JSON 
{
  "choices": [
    string
  ]
}
فیلدها
choices[]

string

انتخاب‌های ممکن.

روش‌ها

create

 کار درسی ایجاد می‌کند.

delete

 یک کار درسی را حذف می‌کند.

get

 کار دوره را برمی‌گرداند.

getAddOnContext

 فراداده‌های افزونه‌های Classroom را در متن یک پست خاص دریافت می‌کند.

list

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

modifyAssignees

 حالت و گزینه‌های مربوط به تکالیف درسی را تغییر می‌دهد.

patch

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