REST Resource: courses.courseWork.addOnAttachments

משאב: AddOnAttachment

קובץ מצורף של תוסף בפוסט.

ייצוג ב-JSON
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "id": string,
  "title": string,
  "teacherViewUri": {
    object (EmbedUri)
  },
  "studentViewUri": {
    object (EmbedUri)
  },
  "studentWorkReviewUri": {
    object (EmbedUri)
  },
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "maxPoints": number,
  "copyHistory": [
    {
      object (CopyHistory)
    }
  ],
  "gradeSyncEnabled": boolean
}
שדות
courseId

string

לא ניתן לשינוי. המזהה של הקורס.

postId
(deprecated)

string

לא ניתן לשינוי. האפשרות הזו יצאה משימוש. במקומה צריך להשתמש ב-itemId.

itemId

string

לא ניתן לשינוי. המזהה של Announcement, CourseWork או CourseWorkMaterial שאליו מצורף הקובץ. ייחודי לכל קורס.

id

string

לא ניתן לשינוי. המזהה שהוקצה לקובץ המצורף הזה ב-Classroom, ייחודי לכל פוסט.

title

string

חובה. שם הקובץ המצורף. הכותרת צריכה להיות באורך של 1 עד 1,000 תווים.

teacherViewUri

object (EmbedUri)

חובה. URI להצגת הקובץ המצורף בתצוגה למורה. ה-URI ייפתח ב-iframe עם הפרמטרים של השאילתה courseId,‏ itemId,‏ itemType ו-attachmentId.

studentViewUri

object (EmbedUri)

חובה. URI להצגת הקובץ המצורף בתצוגה לתלמידים. ה-URI ייפתח ב-iframe עם הפרמטרים של השאילתה courseId,‏ itemId,‏ itemType ו-attachmentId.

studentWorkReviewUri

object (EmbedUri)

URI שמאפשר למורה לראות את העבודה של התלמיד או התלמידה בקובץ המצורף, אם רלוונטי. ה-URI ייפתח ב-iframe עם הפרמטרים של השאילתה courseId,‏ itemId,‏ itemType,‏ attachmentId ו-submissionId. זהו אותו submissionId שמוחזר בשדה AddOnContext.studentContext כשתלמיד צופה בקובץ המצורף. אם משמיטים או מסירים את ה-URI, גם maxPoints יימחק.

dueDate

object (Date)

התאריך, ב-UTC, שבו צריך להגיש את העבודה על הקובץ המצורף הזה. צריך לציין את הערך הזה אם צוין dueTime.

dueTime

object (TimeOfDay)

השעה ביום, ב-UTC, שבה צריך להגיש את העבודה על הקובץ המצורף הזה. צריך לציין את הערך הזה אם צוין dueDate.

maxPoints

number

הציון המקסימלי לקובץ המצורף הזה. אפשר להגדיר רק אם studentWorkReviewUri מוגדר. כדי לציין שהקובץ המצורף תומך בהעברת ציונים, צריך להגדיר ערך שאינו אפס. אם מגדירים את המאפיין הזה, הערך שלו חייב להיות מספר שלם לא שלילי. אם מגדירים את הציון ל-0, הקובץ המצורף לא יתמוך בהעברת ציונים.

copyHistory[]

object (CopyHistory)

פלט בלבד. מזהים של קבצים מצורפים שהיו עותקים קודמים של הקובץ המצורף הזה.

אם הקובץ המצורף הועתק בעבר כי הפוסט הראשי שלו הועתק, כאן מופיעים המזהים של הקבצים המצורפים שהיו העותקים הקודמים שלו, בסדר כרונולוגי עולה של ההעתקה.

gradeSyncEnabled

boolean

פלט בלבד. אם שינויים בערכים של pointsEarned בעבודות שהתלמידים הגישו בקובץ המצורף הזה יועתקו לשדה pointsEarned בעבודות שהתלמידים הגישו ב-CourseWork. השדה הזה יכול להיות true לכל היותר לקובץ מצורף אחד של תוסף לכל פריט בסטרימינג.

Methods

create

יצירת קובץ מצורף של תוסף בפוסט.

delete

מחיקת קובץ מצורף של תוסף.

get

החזרת קובץ מצורף של תוסף.

list

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

patch

עדכון של קובץ מצורף לתוסף.