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

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

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

EmbedUri

ה-URI שיוצג ב-iframe אחרי שהוא יאוכלס בפרמטרים של שאילתות.

ייצוג ב-JSON 
{
  "uri": string
}
שדות
uri

string

חובה. ה-URI שיוצג ב-iframe אחרי שהוא יאוכלס בפרמטרים של שאילתות. זו חייבת להיות מחרוזת UTF-8 תקינה שמכילה בין תו אחד ל-1,800 תווים.

CopyHistory

המזהה של עותק קודם של קובץ מצורף נתון.

ייצוג ב-JSON 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
שדות
courseId

string

לא ניתן לשינוי. המזהה של הקורס.
postId
(deprecated)

string

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

string

לא ניתן לשינוי. המזהה של Announcement,‏ CourseWork או CourseWorkMaterial שבאמצעותם הקובץ המצורף מצורף.
attachmentId

string

לא ניתן לשינוי. המזהה של הקובץ המצורף.

Methods

create

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

delete

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

get

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

list

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

patch

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