Type de ressource « eventMessage »
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 .
Message qui représente une demande de réunion, une annulation ou une réponse. Il peut s’agir de l’une des valeurs suivantes : acceptation, acceptation provisoire ou 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 qu’instance eventMessage avec le meetingMessageType de meetingRequest. En outre, Outlook crée automatiquement une instance d’événement 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.
Outre une demande de réunion, une instance eventMessage peut être trouvée 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.
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",
"endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"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",
"isAllDay": "Boolean",
"isDelegated": true,
"isDeliveryReceiptRequested": true,
"isDraft": true,
"isOutOfDate": "Boolean",
"isRead": true,
"isReadReceiptRequested": true,
"lastModifiedDateTime": "DateTimeOffset",
"location": {"@odata.type": "microsoft.graph.location"},
"meetingMessageType": {"@odata.type": "microsoft.graph.meetingMessageType"},
"mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
"parentFolderId": "string",
"receivedDateTime": "DateTimeOffset",
"recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
"replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
"sender": {"@odata.type": "microsoft.graph.recipient"},
"sentDateTime": "DateTimeOffset",
"startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"subject": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"type": "string",
"uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
"UnsubscribeData": "string",
"UnsubscribeEnabled": true,
"webLink": "string"
}
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. |
| endDateTime | dateTimeTimeZone | Heure de fin de la réunion demandée. |
| flag | 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.
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 les suivantes : 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 | Chaîne | ID du message au format spécifié parRFC5322. |
| isAllDay | Boolean | Indique si l’événement dure toute la journée. L’ajustement de cette propriété nécessite également d’ajuster les propriétés startDateTime et endDateTime de l’événement. |
| 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é. |
| isOutOfDate | Valeur booléenne | Indique si cette demande de réunion a été rendue obsolète par une demande plus récente. |
| 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. |
| location | location | Emplacement de la réunion demandée. |
| meetingMessageType | String | Type de message d’événement : none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined. |
| mentionsPreview | mentionsPreview | Obtenir des informations sur les mentions dans un message. Lors du traitement d’une GET /messages demander, le serveur définit cette propriété et inclut la réponse par défaut. Le serveur renvoie la valeur null s’il n’existe aucune mentions dans le message. Facultatif. |
| parentFolderId | String | Identificateur unique de l’objet mailFolder parent du message. |
| receivedDateTime | DateTimeOffset | Date et heure de réception du message. |
| recurrence | patternedRecurrence | Modèle de périodicité de la réunion demandée. |
| replyTo | Collection recipient | Adresses e-mail à utiliser lors de la réponse. |
| sender | recipient | Compte 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éepour 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. Pour plus d’informations, consultez Définition des propriétés from et sender. |
| sentDateTime | DateTimeOffset | Date et heure d’envoi du message. |
| startDateTime | dateTimeTimeZone | Heure de début de la réunion demandée. |
| subject | String | Objet du message. |
| toRecipients | Collection recipient | Destinataires À: du message. |
| type | Chaîne | Type de réunion demandée : singleInstance, occurence, exception, seriesMaster. |
| uniqueBody | itemBody | Partie du corps du message unique au message en cours. |
| UnsubscribeData | Chaîne | Les entrées valides analysées à partir de l’en-tête Liste Se Désabonner. Il s’agit des données de la commande de courrier dans l’en-tête Liste Se Désabonner si la propriété UnsubscribeEnabled est true. |
| UnsubscribeEnabled | Booléen | Indique si le message est activé pour annuler l’abonnement. Sa valueTrue si l’en-tête Liste Se désabonner est conforme aux rfc 2369. |
| 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 ispopout n’est pas présent ou s’il est défini sur 1, le message s’affiche dans une fenêtre contextuelle. Si ispopout a la valeur 0, le navigateur affiche le message dans le volet de révision d’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. Vous êtes invité à vous connecter si vous n’êtes pas déjà connecté avec le navigateur. Cette URL n’est pas accessible à partir d’un iFrame. |
Relations
| Relation | Type | Description |
|---|---|---|
| pièces jointes | collection attachment | Collection de pièces jointes fileAttachment, itemAttachment et referenceAttachment pour le message. 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. |
| mentions | collectionmention | Un ensemble de mentions dans le message, triées par le createdDateTime à partir du plus récent au plus ancien. Par défaut, un GET /messages ne retourne pas cette propriété, sauf si vous appliquez $expand sur la propriété . |
| 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. |
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Obtenir | 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 ». |
| Copier le message | message | Copie un message vers un dossier. |
| Créer un brouillon pour transférer le message | message | Crée un brouillon du message à transférer. Vous pouvez ensuite mettre à jour ou envoyer le brouillon. |
| Créer un brouillon pour répondre | message | Crée un brouillon du message de réponse. Vous pouvez ensuite mettre à jour ou envoyer le brouillon. |
| Créer un brouillon pour répondre à tous | message | Crée un brouillon du message Répondre à tous. Vous pouvez ensuite mettre à jour ou envoyer le brouillon. |
| Transférer le message | Aucune | Transfère un message. Le message est ensuite enregistré dans le dossier des éléments envoyés. |
| Déplacer le message | message | Déplace un message vers un dossier. Crée une nouvelle copie du message dans le dossier de destination. |
| Répondre à des messages | Aucune | Répondre à l’expéditeur d’un message. Le message est ensuite enregistré dans le dossier des éléments envoyés. |
| Répondre à tous les messages | Aucune | Répond à tous les destinataires d’un message. Le message est ensuite enregistré dans le dossier des éléments envoyés. |
| Envoyer un brouillon de message | Aucune | Envoie un brouillon du message précédemment créé. Le message est ensuite enregistré dans le dossier des éléments envoyés. |
| Message de rappel | message | Rappelez-vous un message dans le dossier Éléments envoyés de la boîte aux lettres de l’utilisateur spécifié. |
| Se désabonner | Aucun | Envoyer un message à l’aide les données et l’adresse spécifiée dans la première commande mailto dans l’en-tête Liste Se désabonner. |
| Supprimer définitivement | Aucune | Supprimez définitivement un message d’événement et placez-le dans le dossier Purges du dossier Éléments récupérables de la boîte aux lettres de l’utilisateur. |
| 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 | Obtenez une extension ouverte identifiée par son nom. |
| Propriétés étendues | ||
| Créer une propriété à valeur unique | eventMessage | Crée une ou plusieurs propriétés étendues à valeur unique dans un eventMessage nouveau ou existant. |
| Obtenir une propriété à valeur unique | eventMessage | Obtient des eventMessages contenant une propriété étendue à valeur unique à l’aide de $expand ou $filter. |
| Créer une propriété à valeurs multiples | eventMessage | Crée une ou plusieurs propriétés étendues à valeurs multiples dans un eventMessage nouveau ou existant. |
| Obtenir une propriété à valeurs multiples | eventMessage | Obtenir un eventMessage contenant une propriété étendue à valeurs multiples à l’aide de $expand. |