Mettre à jour un messageUpdate message

Espace de noms: microsoft.graphNamespace: microsoft.graph

Mettre à jour les propriétés d’un objet message.Update the properties of a message object.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Mail.ReadWriteMail.ReadWrite
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Mail.ReadWriteMail.ReadWrite
ApplicationApplication Mail.ReadWriteMail.ReadWrite

Requête HTTPHTTP request

PATCH /me/messages/{id}
PATCH /users/{id | userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type stringstring Nature des données dans le corps d’une entité. Obligatoire.Nature of the data in the body of an entity. Required.

Corps de la demandeRequest body

Dans le corps de la demande, fournissez les valeurs pour les champs appropriés qui doivent être mis à jour.In the request body, supply the values for relevant fields that should be updated. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conserveront leurs valeurs précédentes ou seront recalculées en fonction des modifications apportées à d’autres valeurs des propriétés.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas changé.For best performance you shouldn't include existing values that haven't changed. Les propriétés suivantes peuvent être mises à jour.The following properties can be updated.

PropriétéProperty TypeType DescriptionDescription
bccRecipientsbccRecipients DestinataireRecipient Destinataires Cci du message.The Bcc recipients for the message.
bodybody ItemBodyItemBody Corps du message.The body of the message. Mise à jour possible uniquement si isDraft = true.Updatable only if isDraft = true.
categoriescategories String collectionString collection Catégories associées au message.The categories associated with the message.
ccRecipientsccRecipients Collection de destinatairesRecipient collection Destinataires Cc du message.The Cc recipients for the message.
flagflag 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 DestinataireRecipient Propriétaire de la boîte aux lettres et expéditeur du message.The mailbox owner and sender of the message. Doit correspondre à la boîte aux lettres réelle utilisée.Must correspond to the actual mailbox used.
importanceimportance ChaîneString Importance du message.The importance of the message. Les valeurs possibles sont : Low, Normal, High.The possible values are: Low, Normal, High.
inferenceClassificationinferenceClassification StringString 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 focused ou other.The possible values are: focused or other.
internetMessageIdinternetMessageId StringString ID du message au format spécifié par RFC2822.The message ID in the format specified by RFC2822. Mise à jour possible uniquement si isDraft = true.Updatable only if isDraft = true.
isDeliveryReceiptRequestedisDeliveryReceiptRequested BooleanBoolean Indique si une confirmation de lecture est demandée pour le message.Indicates whether a read receipt is requested for the message.
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.
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.
replyToreplyTo Collection de destinatairesRecipient collection Adresses e-mail à utiliser lors de la réponse.The email addresses to use when replying. Mise à jour possible uniquement si isDraft = true.Updatable only if isDraft = true.
expéditeursender DestinataireRecipient Compte réellement utilisé pour générer le message.The account that is actually used to generate the message. Peut être mis à jour lorsque vous envoyez un message à partir d’uneboîte aux lettres partagée, ou en envoyant un message comme un déléguer.Updatable 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.
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.
subjectsubject StringString Objet du message.The subject of the message. Mise à jour possible uniquement si isDraft = true.Updatable only if isDraft = true.
toRecipientstoRecipients Collection de destinatairesRecipient collection Destinataires À du message.The To recipients for the message.

Dans la mesure où la ressource message prend en charge des extensions, vous pouvez utiliser l’opération PATCH pour ajouter, mettre à jour ou supprimer vos propres données spécifiques de l’application dans les propriétés personnalisées d’une extension dans une instance message existante.Since the message resource supports extensions, you can use the PATCH operation to add, update, or delete your own app-specific data in custom properties of an extension in an existing message instance.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet message mis à jour dans le corps de la réponse.If successful, this method returns a 200 OK response code and updated message object in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json
Content-length: 248

{
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "inferenceClassification": "other"
}
RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 248

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value",
  "inferenceClassification": "other"
}

Voir aussiSee also