REST Resource: courses.courseWork

منبع: 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),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
فیلدها
courseId

string

شناسه دوره

فقط خواندنی

id

string

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

فقط خواندنی

title

string

عنوان کار این دوره عنوان باید یک رشته معتبر UTF-8 حاوی 1 تا 3000 کاراکتر باشد.

description

string

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

materials[]

object ( Material )

مواد اضافی.

CourseWork نباید بیش از 20 مورد مادی داشته باشد.

state

enum ( CourseWorkState )

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

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" .

dueDate

object ( Date )

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

dueTime

object ( TimeOfDay )

زمان اختیاری روز، در UTC، که ارسال‌ها برای این کار دوره موعد است. در صورتی که dueDate مشخص شده باشد، این باید مشخص شود.

scheduledTime

string ( Timestamp format)

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

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

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 مورد استفاده برای بازیابی این منبع.

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

object ( Assignment )

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

فقط خواندنی

multipleChoiceQuestion

object ( MultipleChoiceQuestion )

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

gradingPeriodId

string

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

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

CourseWorkState

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

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

SubmissionModificationMode

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

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED هیچ حالت اصلاحی مشخص نشده است. این هرگز برگردانده نمی شود.
MODIFIABLE_UNTIL_TURNED_IN موارد ارسالی را می توان قبل از تحویل تغییر داد.
MODIFIABLE موارد ارسالی را می توان در هر زمان تغییر داد.

تکلیف

جزئیات اضافی برای تکالیف

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

object ( DriveFolder )

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

MultipleChoiceQuestion

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

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

string

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

روش ها

create

 کار دوره ای ایجاد می کند.

delete

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

get

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

getAddOnContext

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

list

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

modifyAssignees

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

patch

 یک یا چند زمینه از یک کار دوره را به روز می کند.