Method: courses.announcements.addOnAttachments.create

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

itemId

string

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

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

פרמטרים
postId
(deprecated)

string

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

addOnToken

string

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

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

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

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

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

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