Method: courses.courseWorkMaterials.addOnAttachments.list

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

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

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

פרמטרים
postId
(deprecated)

string

זה שינוי אופציונלי. מזהה הפוסט במסגרת הקורס שהקבצים המצורפים אליו צריכים לספור. הוצא משימוש. במקומו צריך להשתמש ב-itemId.
pageSize

integer

המספר המקסימלי של קבצים מצורפים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 20 קבצים מצורפים לכל היותר. הערך המקסימלי הוא 20; ערכים שגדולים מ-20 יקובצו ל-20.
pageToken

string

אסימון דף, שהתקבל מקריאה קודמת ב-addOnAttachments.list. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-addOnAttachments.list חייבים להתאים לקריאה שסיפקה את אסימון הדף.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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

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

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

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