Method: courses.announcements.addOnAttachments.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחזירה את כל הקבצים המצורפים שנוצרו על ידי תוסף מתחת לפוסטים.
נדרשת הרשאה ליצירת קבצים מצורפים חדשים בפוסט או לקבצים מצורפים פעילים בפוסט.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED עבור שגיאות גישה.INVALID_ARGUMENT אם הבקשה לא תקינה.NOT_FOUND אם אחד מהמשאבים שזוהו לא קיים.
בקשת HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
כתובת ה-URL משתמשת בתחביר של Transcoding של 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
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["# Method: courses.announcements.addOnAttachments.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nReturns all attachments created by an add-on under the post.\n\nRequires the add-on to have active attachments on the post or have permission to create new attachments on the post.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if one of the identified resources does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n| `itemId` | `string` Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from postId. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `postId` **(deprecated)** | `string` Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `itemId` instead. |\n| `pageSize` | `integer` The maximum number of attachments to return. The service may return fewer than this value. If unspecified, at most 20 attachments will be returned. The maximum value is 20; values above 20 will be coerced to 20. |\n| `pageToken` | `string` A page token, received from a previous `addOnAttachments.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `addOnAttachments.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListAddOnAttachmentsResponse](/workspace/classroom/reference/rest/v1/ListAddOnAttachmentsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.addons.student`\n- `\n https://www.googleapis.com/auth/classroom.addons.teacher`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
