Method: courses.courseWorkMaterials.addOnAttachments.create

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

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

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

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

• 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

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