type de ressource de pièce jointe
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Type de base pour plusieurs types de pièces jointes sur un utilisateur, un message, une tâche ou une publication de groupe qui sert de ressource de base pour les types de pièces jointes dérivés suivants :
- Un fichier (ressource fileAttachment)
- Un élément (contact, événement ou message, représenté par une ressource itemAttachment )
- Un lien vers un fichier (ressource referenceAttachment)
Vous pouvez ajouter du contenu associé à un événement utilisateur, un message, une tâche Outlook ou une publication de groupe sous la forme d’une pièce jointe.
Attention
Les tâches Outlook sont déconseillées et ne retournent plus de données le 10 août 2022. Mettez à jour les applications existantes qui utilisent cette fonctionnalité avec les tâches Outlook.
Les événements des calendriers de groupe ne prennent pas en charge les pièces jointes.
Les tâches Outlook ne prennent pas en charge les pièces jointes de référence.
Remarque : Si vous joignez un fichier à une publication de groupe ou que vous joignez un élément à un événement, un message ou une publication de groupe, limitez la taille de la pièce jointe à 3 Mo.
Si vous joignez un fichier de moins de 3 Mo, vous pouvez ajouter la pièce jointe à un événement utilisateur, à un message ou à une publication de groupe.
Si vous joignez un fichier compris entre 3 Mo et 150 Mo à un événement ou un message, vous pouvez créer une session de chargement et charger de manière itérative des plages du fichier pour l’attacher. Pour obtenir un exemple, consultez Joindre des fichiers volumineux à des messages Outlook .
Méthodes
Les méthodes suivantes s’appliquent à tous les types de pièces jointes dérivés (fileAttachment, itemAttachment ou referenceAttachment).
| Méthode | Type renvoyé | Description |
|---|---|---|
| Obtenir une pièce jointe | attachment | Lire les propriétés, les relations ou le contenu brut d’une pièce jointe, attachée à un événement, un message, une tâche Outlook ou une publication utilisateur. |
| Ajouter une pièce jointe à un événement de l’utilisateur | pièce jointe | Ajoutez un fichier, un élément ou liez une pièce jointe à un événement dans un calendrier de l’utilisateur. Cette opération limite la taille de la pièce jointe à laquelle vous pouvez ajouter moins de 3 Mo. |
| Ajouter une pièce jointe à un message | pièce jointe | Ajoutez une pièce jointe de fichier, élément ou lien à un message. Cette opération limite la taille de la pièce jointe à laquelle vous pouvez ajouter moins de 3 Mo. |
| Créer une session pour joindre un fichier volumineux | uploadSession | Créez une session de chargement qui permet à une application de charger de manière itérative des plages d’un fichier, afin d’attacher le fichier au message ou à l’événement spécifié. La taille du fichier doit être comprise entre 3 Mo et 150 Mo. |
| Ajouter une pièce jointe à une tâche Outlook (déconseillé) | attachment | Ajouter un fichier ou un élément en pièce jointe à une tâche Outlook. |
| Ajouter une pièce jointe à un billet | pièce jointe | Ajouter un fichier, un élément ou lier une pièce jointe à un billet de groupe. Cette opération limite la taille de la pièce jointe à laquelle vous pouvez ajouter moins de 3 Mo. |
| Répertorier les pièces jointes d’un événement de l’utilisateur | collection pièce jointe | Obtenez une liste des pièces jointes pour un événement dans un calendrier de l’utilisateur. |
| Répertorier les pièces jointes d’un message | collection attachment | Obtenez une liste des pièces jointes pour un message. |
| Répertorier les pièces jointes d’une tâche Outlook (déconseillée) | collection attachment | Obtenez la liste des pièces jointes pour une tâche Outlook. |
| Répertorier les pièces jointes d’un billet | collection attachment | Obtenez une liste des pièces jointes pour un billet. |
| Supprimer | Aucun | Supprimer une pièce jointe sur un événement, un message, une tâche Outlook ou une publication. |
Propriétés
Voici les propriétés de base d’une ressource de pièce jointe. Reportez-vous au type de pièce jointe spécifique (fileAttachment, itemAttachment ou referenceAttachment) pour des propriétés supplémentaires.
| Propriété | Type | Description |
|---|---|---|
| contentType | Chaîne | Le type MIME. |
| id | Chaîne | En lecture seule. |
| isInline | Booléen |
true, s’il s’agit d’une pièce jointe incorporée ; sinon, false. |
| lastModifiedDateTime | DateTimeOffset | Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| name | Chaîne | Nom d’affichage de la pièce jointe. Il n’est pas nécessaire qu’il s’agisse du nom de fichier réel. |
| size | Int32 | Longueur de la pièce jointe en octets. |
Relations
Aucun
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"contentType": "string",
"id": "string (identifier)",
"isInline": true,
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"size": 1024
}