type de ressource de pièce jointe

  • Article

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 .

Attention

Les applications existantes qui utilisent cette fonctionnalité avec les tâches Outlook doivent être mises à jour, car les tâches Outlook sont déconseillées. Pour plus d’informations, consultez API To Do en préversion publique .

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.

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.

attachment est la ressource de base pour les types de pièces jointes dérivés suivants :

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 Aucune 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
}