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

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

id

string

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

title

string

חובה. הכותרת של הקובץ המצורף. הכותרת צריכה להכיל בין 1 ל-1,000 תווים.

teacherViewUri

object (EmbedUri)

חובה. URI להצגת התצוגה של הקובץ המצורף למורה. ה-URI ייפתח ב-iframe שבו יוגדרו הפרמטרים של השאילתה courseId, postId ו-attachmentId.

studentViewUri

object (EmbedUri)

חובה. URI להצגת הקובץ המצורף לתלמידים. ה-URI ייפתח ב-iframe שבו יוגדרו הפרמטרים של השאילתה courseId, postId ו-attachmentId.

studentWorkReviewUri

object (EmbedUri)

URI למורה כדי לראות עבודות של תלמידים על הקובץ המצורף, אם רלוונטי. ה-URI ייפתח ב-iframe שבו יוגדרו הפרמטרים של השאילתה courseId, postId, attachmentId ו-submissionId. זה אותו submissionId שהוחזר על ידי [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] כשתלמיד צופה בקובץ המצורף. אם ה-URI יושמט או יוסר, גם maxPoints יימחק.

dueDate

object (Date)

תאריך היעד (לפי שעון UTC) לגבי העבודה על הקובץ המצורף הזה. צריך לציין את זה אם מציינים dueTime.

dueTime

object (TimeOfDay)

מועד ההגשה של הקובץ המצורף הזה הוא השעה ביום (לפי שעון UTC). צריך לציין את זה אם מציינים dueDate.

maxPoints

number

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

copyHistory[]

object (CopyHistory)

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

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

EmbedUri

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

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

string

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

CopyHistory

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

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

string

בלתי ניתן לשינוי. מזהה הקורס.

postId
(deprecated)

string

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

itemId

string

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

attachmentId

string

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

שיטות

create

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

delete

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

get

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

list

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

patch

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