Method: courses.announcements.addOnAttachments.create

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
• היקפי ההרשאות

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

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

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

• 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

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