REST Resource: courses.posts.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)
    }
  ]
}
שדות
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 מוגדר. צריך להגדיר ערך שאינו אפס כדי לציין שהקובץ המצורף תומך בחשיפה חוזרת בציון. אם הערך מוגדר, הוא חייב להיות מספר שלם לא שלילי. אם הערך שמוגדר הוא אפס, הקובץ המצורף לא יתמוך בחשיפה חוזרת של הציון.

copyHistory[]

object (CopyHistory)

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

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

שיטות

create

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

delete

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

get

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

list

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

patch

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