Type de ressource « eventMessage »

Article
03/26/2023

Espace de noms: microsoft.graph

Message qui représente une demande de réunion, une annulation ou une réponse (qui peut être une acceptation, une acceptation provisoire ou un refus).

L’entité eventMessage est dérivée de message. eventMessage est le type de base pour eventMessageRequest et eventMessageResponse. La propriété meetingMessageType identifie le type de message d’événement.

Lorsqu’un organisateur ou une application envoie une demande de réunion, la demande de réunion arrive dans la boîte aux lettres d’un invité en tant que instance eventMessage avec le meetingMessageType de meetingRequest. En outre, Outlook crée automatiquement un événement instance dans le calendrier de l’invité, avec la propriété showAs comme provisoire.

Pour obtenir les propriétés de l’événement associé dans la boîte aux lettres de l’invité, l’application peut utiliser la propriété de navigation des événements de eventMessage, comme illustré dans cet exemple de message d’événement get. L’application peut également répondre à l’événement au nom de l’invité par programmation, en acceptant, en acceptant provisoirement ou en refusant l’événement.

En plus d’une demande de réunion, un eventMessage instance se trouve dans la boîte aux lettres d’un invité suite à l’annulation d’une réunion par un organisateur d’événement ou dans la boîte aux lettres de l’organisateur suite à la réponse d’un invité à la demande de réunion. Une application peut agir sur les messages d’événements pratiquement de la même manière que sur les messages.

Méthodes

Méthode	Type renvoyé	Description
Obtenir un eventMessage	eventMessage	Lit les propriétés et les relations de l’objet « eventmessage ».
Mettre à jour	eventMessage	Met à jour l’objet « eventMessage ».
Supprimer	Aucun	Supprime un objet « eventMessage ».
copy	message	Copier un message vers un dossier.
createForward	message	Crée un brouillon du message à transférer. Vous pouvez ensuite mettre à jour ou envoyer le brouillon.
createReply	message	Crée un brouillon du message de réponse. Vous pouvez ensuite mettre à jour ou envoyer le brouillon.
createReplyAll	message	Crée un brouillon du message Répondre à tous. Vous pouvez ensuite mettre à jour ou envoyer le brouillon.
Transférer	Aucun	Transfère un message. Le message est ensuite enregistré dans le dossier des éléments envoyés.
move	message	Déplace un message vers un dossier. Crée une nouvelle copie du message dans le dossier de destination.
Répondre	Aucun	Répondre à l’expéditeur d’un message. Le message est ensuite enregistré dans le dossier des éléments envoyés.
replyAll	Aucun	Répond à tous les destinataires d’un message. Le message est ensuite enregistré dans le dossier des éléments envoyés.
Envoyer	Aucun	Envoie un brouillon du message précédemment créé. Le message est ensuite enregistré dans le dossier des éléments envoyés.
Attachments
Répertorier les pièces jointes	Collection attachment	Obtient toutes les pièces jointes d’un élément eventMessage.
Add attachment	attachment	Ajoute une nouvelle pièce jointe à un élément eventMessage en publiant dans la collection d’objets attachment.
Extensions d’ouverture
Créer une extension d’ouverture	openTypeExtension	Crée une extension d’ouverture et ajoute des propriétés personnalisées dans une instance nouvelle ou existante d’une ressource.
Obtenir une extension d’ouverture	collection openTypeExtension	Obtient un objet d’extension d’ouverture ou des objets identifiés par leur nom ou leur nom complet.
Propriétés étendues
Créer une propriété étendue à valeur unique	eventMessage	Crée une ou plusieurs propriétés étendues à valeur unique dans un eventMessage nouveau ou existant.
Obtenir un eventMessage avec la propriété étendue à valeur unique	eventMessage	Obtient des eventMessages contenant une propriété étendue à valeur unique à l’aide de `$expand` ou `$filter`.
Créer une propriété étendue à valeurs multiples	eventMessage	Crée une ou plusieurs propriétés étendues à valeurs multiples dans un eventMessage nouveau ou existant.
Obtenir un eventMessage avec la propriété étendue à valeurs multiples	eventMessage	Obtenir un eventMessage contenant une propriété étendue à valeurs multiples à l’aide de `$expand`.

Propriétés

Propriété	Type	Description
bccRecipients	Collection recipient	Destinataires Cci: du message.
corps	itemBody	Corps du message. Il peut avoir le format HTML ou texte.
bodyPreview	String	Les 255 premiers caractères du corps du message. Il a le format texte.
categories	String collection	Catégories associées au message.
ccRecipients	Collection recipient	Destinataires Cc: du message.
changeKey	String	Version du message.
conversationId	String	ID de la conversation à laquelle appartient l’e-mail.
conversationIndex	Edm.Binary	Indique la position du message au sein de la conversation.
createdDateTime	DateTimeOffset	Date et heure de la création du message.
indicateur	followupFlag	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.
from	recipient	Le propriétaire de la boîte aux lettres à partir de laquelle le message est envoyé. Dans la plupart des cas, cette valeur est identique à la propriété sender, sauf pour les scénarios de partage ou de délégation. La valeur doit correspondre à la boîte aux lettres réelle utilisée. En savoir plus sur définir les propriétés de «from» et «sender»d’un message.
hasAttachments	Boolean	Indique si le message contient des pièces jointes.
id	Chaîne	Identificateur unique du message d’événement. Par défaut, cette valeur change lorsque l’élément est déplacé d’un conteneur (tel qu’un dossier ou un calendrier) vers un autre. Pour modifier ce comportement, utilisez l’en-tête `Prefer: IdType="ImmutableId"`. Pour plus d’informations, consultez Obtenir des identificateurs immuables pour les ressources Outlook . En lecture seule.
importance	String	Importance du message : `low`, `normal`, `high`.
inferenceClassification	String	Les valeurs possibles sont : `focused`, `other`.
internetMessageHeaders	Collection internetMessageHeader	Collection d’en-têtes de message, définis par RFC5322, qui fournissent des détails sur le chemin d’accès réseau adopté par un message pour aller de l’expéditeur au destinataire. En lecture seule.
internetMessageId	String	ID du message au format spécifié par RFC2822.
isDelegated	Valeur booléenne	True si cette demande de réunion est accessible à un délégué ; sinon, false. La valeur par défaut est False.
isDeliveryReceiptRequested	Boolean	Indique si une confirmation de lecture est demandée pour le message.
isDraft	Booléen	Indique si le message est un brouillon. Un message est un brouillon s’il n’a pas encore été envoyé.
isRead	Boolean	Indique si le message a été lu.
isReadReceiptRequested	Boolean	Indique si une confirmation de lecture est demandée pour le message.
lastModifiedDateTime	DateTimeOffset	Date et heure de la dernière modification du message.
meetingMessageType	meetingMessageType	Type de message d’événement : `none`, `meetingRequest`, `meetingCancelled`, `meetingAccepted`, `meetingTenativelyAccepted`, `meetingDeclined`.
parentFolderId	String	Identificateur unique de l’objet mailFolder parent du message.
receivedDateTime	DateTimeOffset	Date et heure de réception du message.
replyTo	Collection recipient	Adresses e-mail à utiliser lors de la réponse.
sender	recipient	Compte réellement utilisé pour générer le message. Dans la plupart des cas, cette valeur est identique à la propriété de. Vous pouvez définir cette propriété à une valeur différente lorsque vous envoyez un message à partir d’une boîte aux lettres partagée pour un calendrier partagé, ou comme délégué. Dans tous les cas, la valeur doit correspondre à la boîte aux lettres réelle utilisée. En savoir plus sur définir les propriétés de «from» et «sender»d’un message.
sentDateTime	DateTimeOffset	Date et heure d’envoi du message.
subject	String	Objet du message.
toRecipients	Collection recipient	Destinataires À: du message.
uniqueBody	itemBody	Partie du corps du message unique au message en cours.
webLink	Chaîne	L’URL permettant d’ouvrir le message dans Outlook sur le web. 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 de Outlook sur le Web. Le message s’ouvre dans le navigateur si vous êtes connecté à votre boîte aux lettres via Outlook sur le web. Si vous n’êtes pas déjà connecté avec le navigateur, vous êtes invité à le faire. Impossible d’accéder à cette URL à partir d’un iFrame.

Relations

Relation	Type	Description
pièces jointes	Collection attachment	En lecture seule. Peut avoir la valeur Null.
event	event	Événement associé au message d’événement. Les participants ou les ressources d’équipement supposent que l’Intendant Calendrier est configuré pour mettre automatiquement à jour le calendrier avec un événement lors de la réception de demandes de réunion. Propriété de navigation. En lecture seule.
extensions	Collection extension	Collection d’extensions ouvertes définies pour eventMessage. En lecture seule. Pouvant accepter la valeur Null.
multiValueExtendedProperties	collection multiValueLegacyExtendedProperty	Collection de propriétés étendues à valeurs multiples définies pour l’eventMessage. En lecture seule. Pouvant accepter la valeur Null.
singleValueExtendedProperties	collection singleValueLegacyExtendedProperty	Collection de propriétés étendues à valeur unique définies pour l’eventMessage. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "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",
  "conversationIndex": "String (binary)",
  "createdDateTime": "DateTimeOffset",
  "event": { "@odata.type": "microsoft.graph.event" },
  "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",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "meetingMessageType": "String",
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string"
}