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
}
שדות
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

מזהה של הנושא שחומר העבודה הזה קשור אליו. הנושא צריך להיות זהה לנושא קיים בקורס.

CourseWorkMaterialState

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

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

Methods

create

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

delete

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

get

 מחזירה חומר לימודי.

getAddOnContext

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

list

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

patch

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