Method: courses.announcements.addOnAttachments.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie toutes les pièces jointes créées par un module complémentaire sous le post.
Le module complémentaire doit disposer de pièces jointes actives sur le post ou être autorisé à en créer.
Cette méthode renvoie les codes d'erreur suivants:
PERMISSION_DENIED pour les erreurs d'accès.INVALID_ARGUMENT si la requête est incorrecte.NOT_FOUND si l'une des ressources identifiées n'existe pas.
Requête HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
courseId |
string
Obligatoire. Identifiant du cours.
|
itemId |
string
Identifiant de l'Announcement, de l'CourseWork ou de l'CourseWorkMaterial dont les pièces jointes doivent être énumérées. Ce champ est obligatoire, mais n'est pas marqué comme tel pendant la migration depuis postId.
|
Paramètres de requête
| Paramètres |
postId
(deprecated) |
string
Facultatif. Identifiant du post du cours dont vous souhaitez énumérer les pièces jointes. Obsolète, utilisez plutôt itemId.
|
pageSize |
integer
Nombre maximal de pièces jointes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si ce paramètre n'est pas spécifié, 20 pièces jointes au maximum sont renvoyées. La valeur maximale est 20. Les valeurs supérieures sont réduites à 20.
|
pageToken |
string
Jeton de page reçu d'un appel addOnAttachments.list précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à addOnAttachments.list doivent correspondre à l'appel ayant fourni le jeton de page.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de ListAddOnAttachmentsResponse.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
