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

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