Method: courses.announcements.addOnAttachments.list

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

המזהה של ההודעה, של הקורסworkWork או של האחריות לחומר הלימוד, שיש לספור את הקבצים המצורפים שלהם. חובה למלא את השדה הזה, אבל הוא לא מסומן ככזה בזמן שאנחנו מבצעים העברה מ-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

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