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

מזהה שהוקצה על ידי Classroom לחומר הזה של עבודת הכיתה, ייחודי לכל קורס.

קריאה בלבד.
title

string

שם החומר הזה של העבודה. הכותרת צריכה להיות מחרוזת תקינה בקידוד UTF-8, באורך של 1 עד 3,000 תווים.
description

string

תיאור אופציונלי של חומר העבודה הזה. הטקסט צריך להיות מחרוזת תקינה בקידוד UTF-8, באורך של עד 30,000 תווים.
materials[]

object (Material)

חומרים נוספים.

חומר לימודי של קורס יכול לכלול עד 20 פריטים.
state

enum (CourseWorkMaterialState)

הסטטוס של חומר העבודה בקורס. אם לא מצוין ערך, מצב ברירת המחדל הוא DRAFT.
creationTime

string (Timestamp format)

חותמת הזמן שבה נוצר חומר העבודה הזה.

קריאה בלבד.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 יכולים להיות עד 10 יעדי למידה. השדה הזה מאוכלס רק אם מוגדר הערך המתאים של previewVersion.

CourseWorkMaterialState

מצבים אפשריים של חומר לימוד

טיפוסים בני מנייה (enum)
COURSEWORK_MATERIAL_STATE_UNSPECIFIED לא צוינה מדינה. הערך הזה אף פעם לא מוחזר.
PUBLISHED הסטטוס של חומר הלימוד שפורסם. זהו מצב ברירת המחדל.
DRAFT הסטטוס של חומר לימוד לעבודה בקורס שעדיין לא פורסם. חומרי עבודה במצב הזה גלויים רק למורים בקורס ולאדמינים בדומיין.
DELETED הסטטוס של חומר לימוד לעבודה בקורס שפורסם אבל נמחק. חומרי עבודה במצב הזה גלויים רק למורים בקורס ולאדמינים בדומיין. חומרים של עבודות בקורס שנמצאים במצב הזה נמחקים אחרי זמן מה.

Methods

create

 יוצרת חומר לימוד.

delete

 מחיקת חומר לימוד בקורס.

get

 מחזירה חומר לימודי בקורס.

getAddOnContext

 קבלת מטא-נתונים של תוספים ל-Classroom בהקשר של פוסט ספציפי.

list

 מחזירה רשימה של חומרי לימוד בקורס שהשולח מורשה לצפות בהם.

patch

 מעדכן שדה אחד או יותר בחומר לימודי של מטלה.