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 ל-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

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

שיטות

create

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

delete

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

get

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

list

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

patch

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