REST Resource: courses.courseWorkMaterials.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

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