Type de ressource « message »message resource type

Message dans une ressource mailFolder.A message in a mailFolder.

Cette ressource prend en charge les fonctions suivantes :This resource supports:

  • Ajouter vos propres données comme en-têtes de message Internet personnalisés.Adding your own data as custom Internet message headers. Ajouter des en-têtes personnalisés uniquement lorsque vous créez un message et nommer en commençant par « x- ».Add custom headers only when creating a message, and name them starting with "x-". Une fois que le message a été envoyé, vous ne pouvez pas modifier les en-têtes.Once the message has been sent, you cannot modify the headers. Pour obtenir les en-têtes d’un message, appliquer le $select paramètre de requête dans une opérationafficher un message.To get the headers of a message, apply the $select query parameter in a get message operation.
  • Ajout de vos propres données aux propriétés personnalisées à l’aide des extensions.Adding your own data as custom properties as extensions.
  • Abonnementaux notifications de modification.Subscribing to change notifications.
  • Utilisation de la requête delta pour effectuer le suivi des suppressions, des mises à jour et des ajouts incrémentiels à l’aide de la fonction delta.Using delta query to track incremental additions, deletions, and updates, by providing a delta function.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Répertorier des messagesList messages collection messagemessage collection Obtient tous les messages dans la boîte aux lettres de l’utilisateur connecté (y compris les dossiers Éléments supprimés et Courrier pêle-mêle).Get all the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
Créer un messageCreate message messagemessage Crée le brouillon d’un nouveau message.Create a draft of a new message.
Obtenir un messageGet message messagemessage Lis les propriétés et les relations de l’objet « message ».Read properties and relationships of message object.
Mettre à jourUpdate messagemessage Met à jour l’objet du message.Update message object.
SupprimerDelete AucunNone Supprime l’objet du message.Delete message object.
Copiercopy MessageMessage Copie un message vers un dossier.Copy a message to a folder.
createForwardcreateForward MessageMessage Crée un brouillon du message à transférer. Vous pouvez ensuite mettre à jour ou envoyer le brouillon.Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply MessageMessage Crée un brouillon du message de réponse. Vous pouvez ensuite mettre à jour ou envoyer le brouillon.Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll MessageMessage Crée un brouillon du message Répondre à tous. Vous pouvez ensuite mettre à jour ou envoyer le brouillon.Create a draft of the Reply All message. You can then update or send the draft.
deltadelta collection messagemessage collection Obtenez un ensemble de messages qui ont été ajoutés, supprimés ou mis à jour dans un dossier spécifié.Get a set of messages that have been added, deleted, or updated in a specified folder.
Transférerforward NoneNone Transfère un message. Le message est ensuite enregistré dans le dossier des éléments envoyés.Forward a message. The message is then saved in the Sent Items folder.
Déplacermove MessageMessage Déplace le message vers un dossier. Crée une nouvelle copie du message dans le dossier de destination.Move the message to a folder. This creates a new copy of the message in the destination folder.
Répondrereply NoneNone Répond à l’expéditeur d’un message Le message est ensuite enregistré dans le dossier des éléments envoyés.Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll NoneNone Répond à tous les destinataires d’un message. Le message est ensuite enregistré dans le dossier des éléments envoyés.Reply to all recipients of a message. The message is then saved in the Sent Items folder.
Envoyersend NoneNone Envoie un brouillon du message précédemment créé. Le message est ensuite enregistré dans le dossier des éléments envoyés.Sends a previously created message draft. The message is then saved in the Sent Items folder.
AttachmentsAttachments
Répertorier les pièces jointesList attachments collection attachmentAttachment collection Obtient toutes les pièces jointes d’un message.Gets all attachments on a message.
Add attachmentAdd attachment AttachmentAttachment Ajoute une nouvelle pièce jointe à un message en publiant dans la collection d’objets « attachment » .Add a new attachment to a message by posting to the attachments collection.
Extensions d’ouvertureOpen extensions
Créer une extension d’ouvertureCreate open extension openTypeExtensionopenTypeExtension Crée une extension d’ouverture et ajoute des propriétés personnalisées dans une instance nouvelle ou existante d’une ressource.Create an open extension and add custom properties in a new or existing instance of a resource.
Obtenir une extension d’ouvertureGet open extension collection openTypeExtensionopenTypeExtension collection Obtenir un objet d’extension d’ouverture ou des objets identifiés par leur nom ou leur nom complet.Get an open extension object or objects identified by name or fully qualified name.
Extensions de schémaSchema extensions
Ajouter des valeurs d’extension de schémaAdd schema extension values Créer une définition d’extension de schéma, puis l’utiliser pour ajouter des données personnalisées à une ressource.Create a schema extension definition and then use it to add custom typed data to a resource.
Propriétés étenduesExtended properties
Créer une propriété étendue à valeur uniqueCreate single-value extended property messagemessage Crée une ou plusieurs propriétés étendues à valeur unique dans un message nouveau ou existant.Create one or more single-value extended properties in a new or existing message.
Obtenir un message avec une propriété étendue à valeur uniqueGet message with single-value extended property messagemessage Obtient les messages contenant une propriété étendue à valeur unique à l’aide de $expand ou $filter.Get messages that contain a single-value extended property by using $expand or $filter.
Créer une propriété étendue à valeurs multiplesCreate multi-value extended property messagemessage Crée une ou plusieurs propriétés étendues à valeurs multiples dans un message nouveau ou existant.Create one or more multi-value extended properties in a new or existing message.
Obtenir un message avec une propriété étendue à valeurs multiplesGet message with multi-value extended property messagemessage Obtient un message qui contient une propriété étendue à valeurs multiples à l’aide de $expand.Get a message that contains a multi-value extended property by using $expand.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
bccRecipientsbccRecipients Collection recipientrecipient collection Destinataires Cci: du message.The Bcc: recipients for the message.
corpsbody itemBodyitemBody Corps du message.The body of the message. Il peut avoir le format HTML ou texte.It can be in HTML or text format. En savoir plus sursauvegarder HTML dans le corps d’un message.Find out about safe HTML in a message body.
bodyPreviewbodyPreview StringString Les 255 premiers caractères du corps du message. Il a le format texte.The first 255 characters of the message body. It is in text format.
categoriescategories String collectionString collection Catégories associées au message.The categories associated with the message.
ccRecipientsccRecipients Collection recipientrecipient collection Destinataires Cc: du message.The Cc: recipients for the message.
changeKeychangeKey StringString Version du message.The version of the message.
conversationIdconversationId StringString ID de la conversation à laquelle appartient l’e-mail.The ID of the conversation the email belongs to.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Date et heure de la création du message.The date and time the message was created.
indicateurflag followupFlagfollowupFlag La valeur d’indicateur qui indique le statut, la date de début, la date d’échéance ou la date d’achèvement du message.The flag value that indicates the status, start date, due date, or completion date for the message.
fromfrom recipientrecipient Propriétaire de la boîte aux lettres et expéditeur du message.The mailbox owner and sender of the message. La valeur doit correspondre à la boîte aux lettres réelle utilisée.The value must correspond to the actual mailbox used. En savoir plus sur définir les propriétés de «from» et «sender»d’un message.Find out more about setting the from and sender properties of a message.
hasAttachmentshasAttachments BooleanBoolean Indique si le message contient des pièces jointes. Cette propriété n’inclut pas les pièces jointes intégrées au corps du message. Si un message contient ce type de pièces jointes, cette propriété a la valeur false. Pour vérifier l’existence de pièces jointes intégrées au corps du message, analysez la propriété body pour voir si elle contient un attribut src, tel que <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.Indicates whether the message has attachments. This property doesn't include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.
idid StringString Identificateur unique du message (notez que cette valeur peut changer si un message est déplacé ou modifié)Unique identifier for the message (note that this value may change if a message is moved or altered)
importanceimportance importanceimportance Importance du message : Low, Normal, High.The importance of the message: Low, Normal, High.
inferenceClassificationinferenceClassification inferenceClassificationTypeInferenceClassificationType Le classement du message de l’utilisateur, en fonction de l’importance ou de la pertinence déduite, ou d’un remplacement explicite.The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. Les valeurs possibles sont focusedouother.The possible values are: focused or other.
internetMessageHeadersinternetMessageHeaders Collection internetMessageHeaderinternetMessageHeader collection Une collection d’en-têtes de message définie par RFC5322.A collection of message headers defined by RFC5322. Le jeu comporte des en-têtes de message indiquant que le chemin d’accès réseau est pris par un message de l’expéditeur au destinataire.The set includes message headers indicating the network path taken by a message from the sender to the recipient. Il peut également contenir des en-têtes de message personnalisées qui contiennent des données de l’application du message.It can also contain custom message headers that hold app data for the message.

Renvoyé uniquement en appliquant une$selectoption requête.Returned only on applying a $select query option. En lecture seule.Read-only.
internetMessageIdinternetMessageId StringString ID du message au format spécifié par RFC2822.The message ID in the format specified by RFC2822.
isDeliveryReceiptRequestedisDeliveryReceiptRequested BooleanBoolean Indique si une confirmation de lecture est demandée pour le message.Indicates whether a read receipt is requested for the message.
isDraftisDraft BooleanBoolean Indique si le message est un brouillon. Un message est un brouillon s’il n’a pas encore été envoyé.Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isReadisRead BooleanBoolean Indique si le message a été lu.Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested BooleanBoolean Indique si une confirmation de lecture est demandée pour le message.Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Date et heure de la dernière modification du message.The date and time the message was last changed.
parentFolderIdparentFolderId StringString Identificateur unique de l’objet mailFolder parent du message.The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset Date et heure de réception du message.The date and time the message was received.
replyToreplyTo Collection recipientrecipient collection Adresses e-mail à utiliser lors de la réponse.The email addresses to use when replying.
sendersender recipientrecipient Compte réellement utilisé pour générer le message.The account that is actually used to generate the message. Dans la plupart des cas, cette valeur est identique à la propriété de.In most cases, this value is the same as the from property. Vous pouvez définir cette propriété à une valeur différente lorsque vous envoyez un message à partir d’uneboîte aux lettres partagée, ou en envoyant un message comme un déléguer.You can set this property to a different value when sending a message from a shared mailbox, or sending a message as a delegate. Dans tous les cas, la valeur doit correspondre à la boîte aux lettres réelle utilisée.In any case, the value must correspond to the actual mailbox used. En savoir plus sur définir les propriétés de «from» et «sender»d’un message.Find out more about setting the from and sender properties of a message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset Date et heure d’envoi du message.The date and time the message was sent.
subjectsubject StringString Objet du message.The subject of the message.
toRecipientstoRecipients Collection recipientrecipient collection Destinataires À: du message.The To: recipients for the message.
uniqueBodyuniqueBody itemBodyitemBody Partie du corps du message qui est unique pour le message en cours. uniqueBody n’est pas fourni par défaut mais peut être récupéré pour un message donné à l’aide de la requête ?$select=uniqueBody. Il peut avoir le format HTML ou texte.The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the ?$select=uniqueBody query. It can be in HTML or text format.
webLinkwebLink StringString URL permettant d’ouvrir le message dans Outlook Web App.The URL to open the message in Outlook Web App.

Vous pouvez ajouter un argument ispopout à la fin de l’URL pour modifier l’affichage du message. Si l’argument ispopout n’existe pas ou s’il est défini sur 1, le message s’affiche dans une fenêtre contextuelle. Si l’argument ispopout est défini sur 0, le navigateur affiche le message dans le volet de révision d’Outlook Web App.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook Web App review pane.

Le message s’ouvre dans le navigateur si vous êtes connecté à votre boîte aux lettres via Outlook Web App. Si vous n’êtes pas déjà connecté avec le navigateur, vous êtes invité à le faire.The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Cette URL est accessible à partir d’un iFrame.This URL can be accessed from within an iFrame.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
pièces jointesattachments collection attachmentattachment collection Pièces jointes fileAttachment et itemAttachment du message.The fileAttachment and itemAttachment attachments for the message.
extensionsextensions collection extensionextension collection Collection des extensions d’ouverture définies pour le message.The collection of open extensions defined for the message. Pouvant accepter la valeur Null.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties collection multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection Collection des propriétés étendues à valeurs multiples définies pour le message.The collection of multi-value extended properties defined for the message. Pouvant accepter la valeur Null.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties collection singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection Collection des propriétés étendues à valeur unique définies pour le message.The collection of single-value extended properties defined for the message. Pouvant accepter la valeur Null.Nullable.

Représentation JSONJSON representation

Voici une représentation JSON de la ressourceHere is a JSON representation of the resource

{
  "bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "changeKey": "string",
  "conversationId": "string",
  "createdDateTime": "String (timestamp)",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "string (identifier)",
  "importance": "String",
  "inferenceClassification": "String",
  "internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
  "internetMessageId": "String",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "parentFolderId": "string",
  "receivedDateTime": "String (timestamp)",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string",

  "attachments": [{"@odata.type": "microsoft.graph.attachment"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "multiValueExtendedProperties": [{"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"}],
  "singleValueExtendedProperties": [{"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"}]
}

Voir aussiSee also