Method: courses.courseWorkMaterials.addOnAttachments.create

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

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

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
courseId

string

חובה. מזהה הקורס.
itemId

string

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

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

פרמטרים
postId
(deprecated)

string

אפשרות. הוצא משימוש. במקומו צריך להשתמש ב-itemId.
addOnToken

string

אפשרות. אסימון שמאשר את הבקשה.

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

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

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

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