Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
Method: courses.announcements.addOnAttachments.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Gibt alle Anhänge zurück, die von einem Add-on unter dem Beitrag erstellt wurden.
Das Add-on muss aktive Anhänge im Beitrag haben oder die Berechtigung haben, neue Anhänge im Beitrag zu erstellen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED für Zugriffsfehler.INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.NOT_FOUND, wenn eine der identifizierten Ressourcen nicht vorhanden ist.
HTTP-Anfrage
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
courseId |
string
Erforderlich. Kennung des Kurses.
|
itemId |
string
Kennung der Announcement, CourseWork oder CourseWorkMaterial, deren Anhänge aufgelistet werden sollen. Dieses Feld ist erforderlich, wird aber während der Migration von „postId“ nicht als solches gekennzeichnet.
|
Abfrageparameter
| Parameter |
postId
(deprecated) |
string
Optional. Die ID des Beitrags im Kurs, dessen Anhänge aufgelistet werden sollen. Verworfen, verwenden Sie stattdessen itemId.
|
pageSize |
integer
Die maximale Anzahl der Anhänge, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 20 Anhänge zurückgegeben. Der Höchstwert ist 20. Werte über 20 werden auf 20 festgelegt.
|
pageToken |
string
Ein Seitentoken, das von einem vorherigen addOnAttachments.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für addOnAttachments.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListAddOnAttachmentsResponse.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
