REST Resource: courses.courseWorkMaterials

منبع: CourseWorkMaterial

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

نمایش JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
فیلدها
courseId

string

شناسه دوره.

فقط خواندنی.

id

string

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

فقط خواندنی.

title

string

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

description

string

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

materials[]

object ( Material )

مواد اضافی.

یک منبع درسی نباید بیش از 20 مورد داشته باشد.

state

enum ( CourseWorkMaterialState )

وضعیت این مطالب درسی. اگر مشخص نشده باشد، حالت پیش‌فرض 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" .

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

assigneeMode

enum ( AssigneeMode )

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

individualStudentsOptions

object ( IndividualStudentsOptions )

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

creatorUserId

string

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

فقط خواندنی.

topicId

string

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

learningGoals[]

object ( LearningGoal )

اختیاری.

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

دورهکارمادهدولت

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

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

روش‌ها

create

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

delete

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

get

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

getAddOnContext

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

list

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

patch

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