Method: courses.announcements.addOnAttachments.create

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

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

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • PERMISSION_DENIED עבור שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם אחד מהמשאבים שזוהו לא קיים.

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
courseId

string

חובה. המזהה של הקורס.

itemId

string

המזהה של Announcement,‏ CourseWork או CourseWorkMaterial שבמסגרתו ייווצר הקובץ המצורף. השדה הזה חובה, אבל הוא לא מסומן ככזה בזמן ההעברה מ-postId.

פרמטרים של שאילתה

פרמטרים
postId
(deprecated)

string

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

addOnToken

string

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

האסימון מועבר כפרמטר של שאילתה כשהמשתמש מופנה מ-Classroom לכתובת ה-URL של התוסף.

טוקן ההרשאה הזה נדרש ליצירת קבצים מצורפים ב-Classroom, אבל הוא אופציונלי ליצירת קבצים מצורפים שמוגדרים תחילה לשותפים. הפונקציה מחזירה שגיאה אם לא צוין פרמטר ליצירת קובץ מצורף בשביל השותף, ופרויקטי הפיתוח שבהם נוצר קובץ המצורף ופריט המקור שלו ב-Stream לא תואמים.

גוף הבקשה

גוף הבקשה מכיל מופע של AddOnAttachment.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של AddOnAttachment.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/classroom.addons.teacher

מידע נוסף זמין במדריך ההרשאות.