Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Référence de ressource pour les API REST Courrier, Calendrier, Contacts et Tâche

Cette documentation couvre les ressources nouvelles ou modifiées pour plusieurs emplacements d’événements, le partage de calendrier, les @-Mentions, les réponses rapides, les choix de langue et de fuseau horaire signalés par « (aperçu) ». Les fonctionnalités de la préversion sont sujettes à modification avant la finalisation et peuvent casser le code qui les utilise. Pour cette raison, en général, vous devez utiliser uniquement une version de production d'une API dans votre code de production. Si disponible, v2.0 est actuellement la version préférée.

La version 1.0 de l’API REST Outlook est en voie d’obsolescence. À partir du 1er novembre 2018, les applications ne pourront plus utiliser l’authentification de base avec le point de terminaison REST v1.0 (https://outlook.office.com/api/v1.0). D’ici le 1er novembre 2019, le point de terminaison REST v1.0 sera complètement désactivé et la documentation v1.0 sera supprimée peu de temps après. Commencez à migrer votre application pour utiliser l'API REST Outlook dans la version 1.0 de Microsoft Graph. Voir plus de détails dans notre communiqué.

S'applique à : Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Cet article décrit les paramètres de requête OData, les énumérations, les types complexes, les propriétés et les entités API REST que vous pouvez utiliser avec les API Courrier, Calendrier, Contacts, et Tâche d'Outlook, pour accéder aux données de boîte aux lettres utilisateur dans Office 365, Hotmail.com, Live.com, MSN.com, Outlook.com et Passport.com.

Remarque Pour la simplicité de référence, le reste de cet article utilise « Outlook.com » pour inclure ces domaines de compte Microsoft.

Voir Utiliser l'API Outlook REST pour plus d'informations communes à tous les sous-ensembles de l'API REST Outlook.

La version bêta de l’API ne vous intéresse pas ? Utilisez le contrôle dans le coin supérieur droit et sélectionnez la version que vous souhaitez.

La version 2.0 de l’API ne vous intéresse pas ? Utilisez le contrôle en haut à droite et sélectionnez la version que vous souhaitez.

La version 1.0 de l’API ne vous intéresse pas ? Utilisez le contrôle en haut à droite et sélectionnez la version que vous souhaitez.

Ressources de l’API REST

Conseil Vous pouvez afficher le document de métadonnées complet pour les modèles de données d'entité Courrier, Calendrier, Contacts et Tâche en accédant au $metadata point de terminaison dans un navigateur Web (exemple : https://outlook.office.com/api/beta/$metadata).

Conseil Vous pouvez afficher le document de métadonnées complet pour les modèles de données d'entité Courrier, Calendrier, Contacts et Tâche en accédant au $metadata point de terminaison dans un navigateur Web (exemple : https://outlook.office.com/api/v2.0/$metadata).

Conseil Vous pouvez afficher le document de métadonnées complet pour les modèles de données d'entité Courrier, Calendrier, Contacts et Tâche en accédant au $metadata point de terminaison dans un navigateur Web (exemple : https://outlook.office.com/api/v1.0/$metadata).

Pièce jointe

Un fichier, un élément (contact, événement ou message) ou un lien vers un fichier ou dossier, qui est joint à un événement, un message ou une tâche. Les
ressources fileAttachment, itemAttachment et referenceAttachment correspondantes sont toutes dérivées de la ressource pièce jointe.

Un fichier, un élément (contact, événement ou message) qui est joint à un événement, un message ou une tâche. Les
ressources fileAttachment, itemAttachment et referenceAttachment correspondantes sont toutes dérivées de la ressource pièce jointe.

Un fichier, un élément (contact, événement ou message) qui est joint à un événement ou un message. Les
ressources fileAttachment et itemAttachment correspondantes sont toutes dérivées de la ressource pièce jointe.

Type : Microsoft.OutlookServices.Entity

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ContentTypeChaîneLe type MIME de la pièce jointe.OuiNon
IsInlineBooléentrue , s’il s’agit d’une pièce jointe incorporée ; sinon, false.OuiOui
LastModifiedDateTimeDateTimeOffsetDate et heure de la dernière modification de la pièce jointe. La date et l'heure utilisent le format ISO 8601 et sont toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : « 2014-01-01T00:00:00Z »NonOui
NameChaîneNom d’affichage de la pièce jointe. Cela n'a pas besoin d'être le nom de fichier réel.OuiOui
SizeInt32Longueur de la pièce jointe en octets.NonNon

Calendrier

Un calendrier qui est un conteneur pour les événements.

Type : Microsoft.OutlookServices.Calendar

Une collection de calendriers renvoie un tableau de calendriers dans value propriété de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/calendars/$count

Voir Opérations du calendrier pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
CanEditBooléenTrue si l’utilisateur peut écrire dans le calendrier, False dans le cas contraire. Cette propriété est True pour l’utilisateur qui a créé le calendrier. Cette propriété est également True pour un utilisateur avec qui un calendrier a été partagé et à qui l’accès en écriture a été octroyé.NonOui
CanShareBooléenTrue si l’utilisateur dispose de l’autorisation de partager le calendrier, False dans le cas contraire. Seul l’utilisateur qui a créé le calendrier peut le partager.NonOui
CanViewPrivateItemsBooléenTrue si l’utilisateur peut lire les éléments de calendrier marqués comme privés, False dans le cas contraire.NonOui
ChangeKeyChaîneIdentifie la version de l’objet de calendrier. Chaque fois que le calendrier est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
ColorCalendarColorSpécifie le thème de couleur pour distinguer le calendrier d’autres calendriers dans une interface utilisateur. Les valeurs des propriétés sont : LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1OuiOui
IDChaîneIdentificateur unique du calendrier.NonNon
IsDefaultCalendarBooléen« Vrai » si ce calendrier est le calendrier par défaut de l'utilisateur, sinon « faux ».OuiOui
isSharedBooléen« Vrai » si l'utilisateur a partagé le calendrier avec d'autres utilisateurs, sinon « faux ». Puisque seul l’utilisateur qui a créé le calendrier peut le partager, IsShared et IsSharedWithMe ne peuvent pas être « vrais » pour le même utilisateur.NonOui
IsSharedWithMeBooléen« Vrai » si le calendrier a été partagé avec l’utilisateur, sinon « faux ». Cette propriété est toujours fausse pour un propriétaire de calendrier.NonOui
NameChaîneNom du calendrier.OuiOui
OwnerEmailAddressSi défini, cela représente l’utilisateur qui a créé ou ajouté le calendrier. Pour un calendrier que l’utilisateur a créé ou ajouté, la propriété Owner est définie sur l’utilisateur. Pour un calendrier partagé avec l'utilisateur, la propriété Owner est définie sur la personne qui a partagé ce calendrier avec l’utilisateur.NonOui
CalendarViewCollection(Event)Affichage Calendrier pour le calendrier. Propriété de navigation.NonNon
ÉvénementsCollection(Event)Événements dans le calendrier. Propriété de navigation.NonNon
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
CanEditBooléenTrue si l’utilisateur peut écrire dans le calendrier, False dans le cas contraire. Cette propriété est True pour l’utilisateur qui a créé le calendrier. Cette propriété est également True pour un utilisateur avec qui un calendrier a été partagé et à qui l’accès en écriture a été octroyé.NonOui
CanShareBooléenTrue si l’utilisateur dispose de l’autorisation de partager le calendrier, False dans le cas contraire. Seul l’utilisateur qui a créé le calendrier peut le partager.NonOui
CanViewPrivateItemsBooléenTrue si l’utilisateur peut lire les éléments de calendrier marqués comme privés, False dans le cas contraire.NonOui
ChangeKeyChaîneIdentifie la version de l’objet de calendrier. Chaque fois que le calendrier est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
ColorCalendarColorSpécifie le thème de couleur pour distinguer le calendrier d’autres calendriers dans une interface utilisateur. Les valeurs des propriétés sont : LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1OuiOui
IDChaîneIdentificateur unique du calendrier.NonNon
NameChaîneNom du calendrier.OuiOui
OwnerEmailAddressSi défini, cela représente l’utilisateur qui a créé ou ajouté le calendrier. Pour un calendrier que l’utilisateur a créé ou ajouté, la propriété Owner est définie sur l’utilisateur. Pour un calendrier partagé avec l'utilisateur, la propriété Owner est définie sur la personne qui a partagé ce calendrier avec l’utilisateur.NonOui
CalendarViewCollection(Event)Affichage Calendrier pour le calendrier. Propriété de navigation.NonNon
ÉvénementsCollection(Event)Événements dans le calendrier. Propriété de navigation.NonNon
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
NameChaîneNom du calendrier.OuiOui
ChangeKeyChaîneIdentifie la version de l’objet de calendrier. Chaque fois que le calendrier est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
ColorCalendarColorSpécifie le thème de couleur pour distinguer le calendrier d’autres calendriers dans une interface utilisateur. Les valeurs des propriétés sont : LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1OuiOui
IDChaîneIdentificateur unique du calendrier.NonNon
CalendarViewCollection(Event)Affichage Calendrier pour le calendrier. Propriété de navigation.NonNon
ÉvénementsCollection(Event)Événements dans le calendrier. Propriété de navigation.NonNon

CalendarGroup

Un groupe de calendriers.

Remarque Outlook.com ne prend en charge que le groupe de calendriers par défaut, accessible par le raccourci../me/calendars. Vous ne pouvez pas supprimer ce groupe de calendriers.

Type : Microsoft.OutlookServices.CalendarGroup

Une collection CalendarGroup renvoie un tableau de groupes de calendriers dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/calendargroups/$count

Voir Opérations de CalendarGroup pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
NameChaîneNom du groupe.OuiOui
ChangeKeyChaîneIdentifie la version du groupe de calendriers. Chaque fois que le groupe de calendriers est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
ClassIdChaîneIdentificateur de classe.NonOui
IDChaîneIdentificateur unique du groupe de calendriers.NonNon
CalendriersCollection(Calendar)Calendriers dans le groupe de calendrier. Propriété de navigation.NonNon

Contact

Un contact, qui est un élément d'Outlook permettant aux utilisateurs d’organiser et d’enregistrer des informations sur les personnes et les sociétés avec lesquelles ils communiquent. Les contacts sont contenus dans des dossiers de contacts.

Type : Microsoft.OutlookServices.Contact

Une collection Contact renvoie un tableau de contacts dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/contacts/$count

Voir Opérations de contact pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AssistantNameChaîneNom de l’assistant du contact.OuiOui
AnniversairedatetimeoffsetAnniversaire du contact.OuiOui
CatégoriesCollection(String)Catégories associés au contact.OuiNon
ChangeKeyChaîneIdentifie la version du contact. Chaque fois que le contact est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
EnfantsCollection(String)Noms des enfants du contact.OuiOui
CompanyNameChaîneNom de la société du contact.OuiOui
CreatedDateTimedatetimeoffsetHeure à laquelle le contact a été créé.NonOui
ServiceChaîneDépartement du contact.OuiOui
DisplayNameChaîneNom d’affichage du contact.OuiOui
EmailAddressesCollection(EmailAddress)Adresses e-mail du contact.OuiNon
ExtensionsCollection(Extension)Collection des extensions de données de type ouvert définie pour le contact. En lecture seule. Propriété de navigation.NonOui
FileAsChaîneNom sous lequel le contact est classé.OuiOui
IndicateurFollowupFlagInformations sur tout suivi du contact.OuiOui
SexeChaîneSexe du contact.OuiOui
GenerationChaîneGénération du contact.OuiOui
GivenNameChaîneNom du contact donné.OuiOui
IDChaîneIdentificateur unique du contact.NonNon
ImAddressesCollection(String)Adresses de messagerie instantanée du contact.OuiNon
InitialesChaîneInitiales du contact.OuiOui
JobTitleChaîneFonction du contact.OuiOui
LastModifiedDateTimedatetimeoffsetHeure à laquelle le contact a été modifié.NonOui
ManagerChaîneNom du responsable du contact.OuiOui
MiddleNameChaîneDeuxième prénom du contact.OuiOui
NickNameChaîneSurnom du contact.OuiOui
OfficeLocationChaîneEmplacement du bureau du contact.OuiOui
ParentFolderIdChaîneID du dossier parent du contact.NonNon
PersonalNotesChaîneNotes de l’utilisateur sur le contact.OuiOui
PhonesCollection(Phone)Numéros de téléphone associés au contact, par exemple, les numéros du téléphone résidentiel, du téléphone mobile et du téléphone professionnel.OuiOui
PostalAddressesCollection PhysicalAddressAdresses associées au contact, par exemple, l’adresse personnelle et l’adresse professionnelle.OuiNon
ProfessionChaîneProfession du contact.OuiOui
SpouseNameChaîneNom du conjoint du contact.OuiOui
SurnameChaîneNom de famille du contact.OuiOui
TitleChaîneTitre du contact.OuiNon
Sites webCollection(Website)Sites Web associés au contact.OuiNon
WeddingAnniversaryDateL’anniversaire de mariage du contact.OuiOui
YomiCompanyNameChaîneNom phonétique de la société japonaise du contact. Cette propriété est facultative.OuiNon
YomiGivenNameChaîneNom donné (prénom) phonétique japonais du contact. Cette propriété est facultative.OuiNon
YomiSurnameChaîneNom de famille phonétique japonais du contact. Cette propriété est facultative.OuiNon

Les propriétés de navigation MultiValueExtendedProperties et SingleValueExtendedProperties sont également disponibles pour cette ressource, afin de représenter des collections de types respectifs de propriétés étendues définies pour une instance de ressource. Pour plus d'informations, voir API REST de propriétés étendues.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AssistantNameChaîneNom de l’assistant du contact.OuiOui
AnniversairedatetimeoffsetAnniversaire du contact.OuiOui
BusinessAddressPhysicalAddressAdresse professionnelle du contact.OuiOui
BusinessHomePageChaînePage d’accueil professionnelle du contact.OuiOui
BusinessPhonesCollection(String)Numéros de téléphone professionnels du contact.OuiNon
CatégoriesCollection(String)Catégories associés au contact.OuiNon
ChangeKeyChaîneIdentifie la version du contact. Chaque fois que le contact est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
EnfantsCollection(String)Noms des enfants du contact.OuiOui
CompanyNameChaîneNom de la société du contact.OuiOui
ServiceChaîneDépartement du contact.OuiOui
CreatedDateTimedatetimeoffsetHeure à laquelle le contact a été créé.NonOui
LastModifiedDateTimedatetimeoffsetHeure à laquelle le contact a été modifié.NonOui
DisplayNameChaîneNom d’affichage du contact.OuiOui
EmailAddressesCollection(EmailAddress)Adresses e-mail du contact.OuiNon
ExtensionsCollection(Extension)Collection des extensions de données de type ouvert définie pour le contact. En lecture seule. Propriété de navigation.NonOui
FileAsChaîneNom sous lequel le contact est classé.OuiOui
GenerationChaîneGénération du contact.OuiOui
GivenNameChaîneNom du contact donné.OuiOui
HomeAddressPhysicalAddressAdresse personnelle du contact.OuiOui
HomePhonesCollection(String)Numéros de téléphone personnels du contact.OuiNon
IDChaîneIdentificateur unique du contact.NonNon
ImAddressesCollection(String)Adresses de messagerie instantanée du contact.OuiNon
InitialesChaîneInitiales du contact.OuiOui
JobTitleChaîneFonction du contact.OuiOui
ManagerChaîneNom du responsable du contact.OuiOui
MiddleNameChaîneDeuxième prénom du contact.OuiOui
MobilePhone1ChaîneNuméro de téléphone mobile du contact.OuiOui
NickNameChaîneSurnom du contact.OuiOui
OfficeLocationChaîneEmplacement du bureau du contact.OuiOui
OtherAddressPhysicalAddressAutres adresses du contact.OuiOui
ParentFolderIdChaîneID du dossier parent du contact.NonNon
PersonalNotesChaîneNotes de l’utilisateur sur le contact.OuiOui
ProfessionChaîneProfession du contact.OuiOui
SpouseNameChaîneNom du conjoint du contact.OuiOui
SurnameChaîneNom de famille du contact.OuiOui
TitleChaîneTitre du contact.OuiNon
YomiCompanyNameChaîneNom phonétique de la société japonaise du contact.OuiNon
YomiGivenNameChaîneNom donné (prénom) phonétique japonais du contact.OuiNon
YomiSurnameChaîneNom de famille phonétique japonais du contact.OuiNon

Les propriétés de navigation MultiValueExtendedProperties et SingleValueExtendedProperties sont également disponibles pour cette ressource, afin de représenter des collections de types respectifs de propriétés étendues définies pour une instance de ressource. Pour plus d'informations, voir API REST de propriétés étendues.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AssistantNameChaîneNom de l’assistant du contact.OuiOui
AnniversairedatetimeoffsetAnniversaire du contact.OuiOui
BusinessAddressPhysicalAddressAdresse professionnelle du contact.OuiOui
BusinessHomePageChaînePage d’accueil professionnelle du contact.OuiOui
BusinessPhonesCollection(String)Numéros de téléphone professionnels du contact.OuiNon
CatégoriesCollection(String)Catégories associés au contact.OuiNon
ChangeKeyChaîneIdentifie la version du contact. Chaque fois que le contact est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer des modifications à la version correcte de l’objet.NonNon
EnfantsCollection(String)Noms des enfants du contact.OuiOui
CompanyNameChaîneNom de la société du contact.OuiOui
ServiceChaîneDépartement du contact.OuiOui
DateTimeCreateddatetimeoffsetHeure à laquelle le contact a été créé.NonOui
DateTimeLastModifieddatetimeoffsetHeure à laquelle le contact a été modifié.NonOui
DisplayNameChaîneNom d’affichage du contact.OuiOui
EmailAddressesCollection(EmailAddress)Adresses e-mail du contact.OuiNon
FileAsChaîneNom sous lequel le contact est classé.OuiOui
GenerationChaîneGénération du contact.OuiOui
GivenNameChaîneNom du contact donné.OuiOui
HomeAddressPhysicalAddressAdresse personnelle du contact.OuiOui
HomePhonesCollection(String)Numéros de téléphone personnels du contact.OuiNon
IDChaîneIdentificateur unique du contact.NonNon
ImAddressesCollection(String)Adresses de messagerie instantanée du contact.OuiNon
InitialesChaîneInitiales du contact.OuiOui
JobTitleChaîneFonction du contact.OuiOui
ManagerChaîneNom du responsable du contact.OuiOui
MiddleNameChaîneDeuxième prénom du contact.OuiOui
MobilePhone1ChaîneNuméro de téléphone mobile du contact.OuiOui
NickNameChaîneSurnom du contact.OuiOui
OfficeLocationChaîneEmplacement du bureau du contact.OuiOui
OtherAddressPhysicalAddressAutres adresses du contact.OuiOui
ParentFolderIdChaîneID du dossier parent du contact.NonNon
PersonalNotesChaîneNotes de l’utilisateur sur le contact.OuiOui
ProfessionChaîneProfession du contact.OuiOui
SpouseNameChaîneNom du conjoint du contact.OuiOui
SurnameChaîneNom de famille du contact.OuiOui
TitleChaîneTitre du contact.OuiNon
YomiCompanyNameChaîneNom phonétique de la société japonaise du contact. Cette propriété est facultative.OuiNon
YomiGivenNameChaîneNom donné (prénom) phonétique japonais du contact. Cette propriété est facultative.OuiNon
YomiSurnameChaîneNom de famille phonétique japonais du contact. Cette propriété est facultative.OuiNon

ContactFolder

Un dossier qui contient les contacts.

Type : Microsoft.OutlookServices.ContactFolder

Une collection ContactFolder renvoie un tableau de dossiers de contacts dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/contactfolders/$count

Voir Opérations de ContactFolder pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChildFoldersCollection(ContactFolder)Collection de dossiers enfants dans le dossier. Propriété de navigation.NonNon
ContactsCollection(Contact)Contacts dans le dossier. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage du dossier.OuiOui
IDChaîneIdentificateur unique du dossier de contact.NonNon
ParentFolderIdChaîneID du dossier parent du dossier.NonNon
WellKnownNameChaîneNom du dossier si le dossier est un dossier reconnu. Actuellement contacts est le seul dossier de contacts reconnu.NonNon
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChildFoldersCollection(ContactFolder)Collection de dossiers enfants dans le dossier. Propriété de navigation.NonNon
ContactsCollection(Contact)Contacts dans le dossier. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage du dossier.OuiOui
IDChaîneIdentificateur unique du dossier de contact.NonNon
ParentFolderIdChaîneID du dossier parent du dossier.NonNon
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChildFoldersCollection(ContactFolder)Collection de dossiers enfants dans le dossier. Propriété de navigation.NonNon
ContactsCollection(Contact)Contacts dans le dossier. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage du dossier.OuiOui
IDChaîneIdentificateur unique du dossier de contact.NonNon
ParentFolderIdChaîneID du dossier parent du dossier.NonNon

Événement

Il s’agit de l’événement d’un calendrier.

Type : Microsoft.OutlookServices.Event

Une collection d’événements renvoie un tableau d'événements dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/events/$count

Voir Opérations Event pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AttachmentsCollection(Attachment)La collection des pièces jointes FileAttachment, ItemAttachment, et ReferenceAttachment pour l’événement. Propriété de navigation.NonNon
AttendeesCollection(Attendee)Collection des participants à l’événement.OuiNon
BodyItemBodyCorps du message associé à l’événement.OuiNon
BodyPreviewChaîneAperçu du message associé à l’événement.NonNon
CalendrierCalendrierLe calendrier qui contient l’événement. Propriété de navigation.NonNon
CatégoriesCollection(String)Catégories associées à l’événement.OuiNon
ChangeKeyChaîneIdentifie la version de l’objet « event ». Chaque fois que l’événement est modifié, la propriété ChangeKey change également. Exchange peut ainsi appliquer les modifications à la version correcte de l’objet.NonNon
CreatedDateTimedatetimeoffsetDate et heure auxquelles l’événement a été créé.NonOui
EndDateTimeTimeZoneDate et heure de fin de l’événement.OuiOui
ExtensionsCollection(Extension)Collection des extensions de données de type ouvert définie pour le contact. Propriété de navigation.NonOui
HasAttachmentsbooléenValeur True si l’événement a des pièces jointes.NonOui
IDChaîneIdentificateur unique de l’événement.NonNon
ImportanceImportanceImportance de l’événement : Low, Normal, High.OuiOui
InstancesCollection(Event)Instances de l’événement Propriété de navigation.NonNon
iCalUIdChaîneIdentificateur unique partagé par toutes les instances d’un événement dans différents calendriers.NonOui
IsAllDaybooléenValeur True si l’événement dure toute la journée. Ajuster cette propriété nécessite d'ajuster les propriétés Start et End de l’événement également.OuiOui
IsCancelledbooléenValeur True si l’événement a été annulé.OuiOui
IsOrganizerbooléenValeur True si l’expéditeur du message est également l’organisateur.OuiOui
IsReminderOnBooléenValeur True si une alerte est définie pour rappeler l’événement à l’utilisateur.OuiOui
LastModifiedDateTimedatetimeoffsetDate et heure auxquelles l’événement a été modifié pour la dernière fois.NonOui
LocationLocationInformations sur la localisation de l’événement.OuiOui
LocationsCollection(Location)Localisations où l’événement est tenu.OuiOui
OnlineMeetingUrlChaîneURL pour une réunion en ligne.OuiNon
OrganisateurDestinataireOrganisateur de l’événement.OuiOui
OriginalEndTimeZoneChaîneFuseau horaire de fin défini lors de la création de l’événement. Voir DateTimeTimeZone pour une liste de fuseaux horaires valides.NonOui
OriginalStartTimeZoneChaîneFuseau horaire de début défini lors de la création de l’événement. Voir DateTimeTimeZone pour une liste de fuseaux horaires valides.NonOui
PériodicitéPatternedRecurrenceModèle de périodicité pour l’événement.OuiNon
ReminderMinutesBeforeStartInt32Nombre de minutes avant la date de début de l’événement où l’alerte de rappel a lieu.OuiNon
ResponseRequestedbooléenValeur True si l’expéditeur souhaite une réponse lorsque l’événement est accepté ou refusé.OuiOui
ResponseStatusResponseStatusIndique le type de réponse envoyé en réponse à un message d’événement.NonOui
Critère de diffusionCritère de diffusionIndique le niveau de confidentialité de l’événement : Normal, Personal, Private, Confidential.OuiOui
SeriesMasterIdChaîneCatégories attribuées à l’élément.OuiNon
ShowAsFreeBusyStatusL’état à afficher : Free, Tentative, Busy, Oof, WorkingElsewhere, Unknown.OuiOui
DébutDateTimeTimeZoneHeure de début de l’événement.OuiOui
SubjectChaîneTexte de la ligne d’objet de l’événement.OuiOui
TypeEventTypeLe type d'événement : SingleInstance, Occurrence, Exception, SeriesMaster.OuiOui
WebLinkChaîneURL permettant d’ouvrir l’événement dans Outlook Web App.

L’événement 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.

Cette URL est accessible à partir d’un iFrame.
NonNon

Les propriétés de navigation MultiValueExtendedProperties et SingleValueExtendedProperties sont également disponibles pour cette ressource, afin de représenter des collections de types respectifs de propriétés étendues définies pour une instance de ressource. Pour plus d'informations, voir API REST de propriétés étendues.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AttachmentsCollection(Attachment)La collection des pièces jointes FileAttachment, ItemAttachment, et ReferenceAttachment pour l’événement. Propriété de navigation.NonNon
AttendeesCollection(Attendee)Collection des participants à l’événement.OuiNon
BodyItemBodyCorps du message associé à l’événement.OuiNon
BodyPreviewChaîneAperçu du message associé à l’événement.NonNon
CalendrierCalendrierLe calendrier qui contient l’événement. Propriété de navigation.NonNon
CatégoriesCollection(String)Catégories associées à l’événement.OuiNon
ChangeKeyChaîneIdentifie la version de l’objet « event ». Chaque fois que l’événement est modifié, la propriété ChangeKey change également. Exchange peut ainsi appliquer les modifications à la version correcte de l’objet.NonNon
CreatedDateTimedatetimeoffsetDate et heure auxquelles l’événement a été créé.NonOui
LastModifiedDateTimedatetimeoffsetDate et heure auxquelles l’événement a été modifié pour la dernière fois.NonOui
EndDateTimeTimeZoneHeure de fin de l’événement.OuiOui
ExtensionsCollection(Extension)Collection des extensions de données de type ouvert définie pour le contact. Propriété de navigation.NonOui
HasAttachmentsbooléenValeur True si l’événement a des pièces jointes.NonOui
IDChaîneIdentificateur unique de l’événement.NonNon
ImportanceImportanceImportance de l’événement : Low, Normal, High.OuiOui
InstancesCollection(Event)Instances de l’événement Propriété de navigation.NonNon
iCalUIdChaîneIdentificateur unique partagé par toutes les instances d’un événement dans différents calendriers.NonOui
IsAllDaybooléenValeur True si l’événement dure toute la journée. Ajuster cette propriété nécessite d'ajuster les propriétés Start et End de l’événement également.OuiOui
IsCancelledbooléenValeur True si l’événement a été annulé.OuiOui
IsOrganizerbooléenValeur True si l’expéditeur du message est également l’organisateur.OuiOui
IsReminderOnBooléenValeur True si une alerte est définie pour rappeler l’événement à l’utilisateur.OuiOui
LocationLocationEmplacement de l’événement.OuiOui
OnlineMeetingUrlChaîneURL pour une réunion en ligne.OuiNon
OrganisateurDestinataireOrganisateur de l’événement.OuiOui
OriginalEndTimeZoneChaîneFuseau horaire de fin défini lors de la création de l’événement. Voir DateTimeTimeZone pour une liste de fuseaux horaires valides.NonOui
OriginalStartTimeZoneChaîneFuseau horaire de début défini lors de la création de l’événement. Voir DateTimeTimeZone pour une liste de fuseaux horaires valides.NonOui
PériodicitéPatternedRecurrenceModèle de périodicité pour l’événement.OuiNon
ReminderMinutesBeforeStartInt32Nombre de minutes avant la date de début de l’événement où l’alerte de rappel a lieu.OuiNon
ResponseRequestedbooléenValeur True si l’expéditeur souhaite une réponse lorsque l’événement est accepté ou refusé.OuiOui
ResponseStatusResponseStatusIndique le type de réponse envoyé en réponse à un message d’événement.NonOui
Critère de diffusionCritère de diffusionIndique le niveau de confidentialité de l’événement : Normal = 0, Personnel = 1, Privé = 2, Confidentiel = 3.OuiOui
SeriesMasterIdChaîneCatégories attribuées à l’élément.OuiNon
ShowAsFreeBusyStatusÉtat à afficher : Libre = 0, Provisoire = 1, Occupé(e) = 2, Absence du bureau = 3, TravailleAilleurs = 4, Inconnu = -1.OuiOui
DébutDateTimeTimeZoneHeure de début de l’événement.OuiOui
TypeEventTypeType d’événement : InstanceUnique = 0, Occurrence = 1, Exception = 2, MaîtreSérie = 3.OuiOui
WebLinkChaîneURL permettant d’ouvrir l’événement dans Outlook Web App.

L’événement 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.

Cette URL est accessible à partir d’un iFrame.
NonNon

Les propriétés de navigation MultiValueExtendedProperties et SingleValueExtendedProperties sont également disponibles pour cette ressource, afin de représenter des collections de types respectifs de propriétés étendues définies pour une instance de ressource. Pour plus d'informations, voir API REST de propriétés étendues.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AttachmentsCollection(Attachment)La collection des pièces jointes FileAttachment et ItemAttachment pour l’événement. Propriété de navigation.NonNon
AttendeesCollection(Attendee)Collection des participants à l’événement.OuiNon
BodyItemBodyCorps du message associé à l’événement.OuiNon
BodyPreviewChaîneAperçu du message associé à l’événement.NonNon
CalendrierCalendrierLe calendrier qui contient l’événement. Propriété de navigation.NonNon
CatégoriesCollection(String)Catégories associées à l’événement.OuiNon
ChangeKeyChaîneIdentifie la version de l’objet « event ». Chaque fois que l’événement est modifié, la propriété ChangeKey change également. Exchange peut ainsi appliquer les modifications à la version correcte de l’objet.NonNon
DateTimeCreateddatetimeoffsetDate et heure auxquelles l’événement a été créé.NonOui
DateTimeLastModifieddatetimeoffsetDate et heure auxquelles l’événement a été modifié pour la dernière fois.NonOui
EnddatetimeoffsetDate et heure de fin de l’événement.

Par défaut, l’heure de fin est au format UTC. Vous pouvez spécifier un fuseau horaire facultatif dans EndTimeZone, exprimer l’heure de fin dans ce fuseau horaire et inclure un décalage par rapport à UTC. Notez que si vous utilisez EndTimeZone, vous devez spécifier une valeur pour StartTimeZone également.

Cet exemple indique 25 février 2015, 21:34 au format PST : « 2015-02-25T21:34:00-08:00 ».
OuiOui
EndTimeZoneChaîneIdentifie le fuseau horaire de la réunion pour l’heure de fin de la réunion (voir la propriété End). Cette propriété est définie avec le nom du fuseau horaire tel qu’il est stocké dans Windows. Vous pouvez obtenir les noms des fuseaux horaires en appelant System.TimeZoneInfo.GetSystemTimeZones().

Cette propriété est facultative pour v1.0. Toutefois, cette propriété doit être utilisée si la propriété StartTimeZone est utilisée.

Voir Fuseau horaire pour plus d’informations.
OuiNon
HasAttachmentsbooléenValeur True si l’événement a des pièces jointes.NonOui
IDChaîneIdentificateur unique de l’événement.NonNon
ImportanceImportanceImportance de l’événement : Low, Normal, High.OuiOui
InstancesCollection(Event)Instances de l’événement Propriété de navigation.NonNon
iCalUIdChaîneIdentificateur unique partagé par toutes les instances d’un événement dans différents calendriers.NonOui
IsAllDaybooléenValeur True si l’événement dure toute la journée. Ajuster cette propriété nécessite d'ajuster les propriétés Start et End de l’événement également.OuiOui
IsCancelledbooléenValeur True si l’événement a été annulé.OuiOui
IsOrganizerbooléenValeur True si l’expéditeur du message est également l’organisateur.OuiOui
LocationLocationEmplacement de l’événement.OuiOui
OrganisateurDestinataireOrganisateur de l’événement.OuiOui
PériodicitéPatternedRecurrenceModèle de périodicité pour l’événement.OuiNon
ResponseRequestedbooléenValeur True si l’expéditeur souhaite une réponse lorsque l’événement est accepté ou refusé.OuiOui
ResponseStatusResponseStatusIndique le type de réponse envoyé en réponse à un message d’événement.NonOui
Critère de diffusionCritère de diffusionIndique le niveau de confidentialité de l’événement : Normal = 0, Personnel = 1, Privé = 2, Confidentiel = 3.OuiOui
SeriesMasterIdChaîneCatégories attribuées à l’élément.OuiNon
ShowAsFreeBusyStatusÉtat à afficher : Libre = 0, Provisoire = 1, Occupé(e) = 2, Absence du bureau = 3, TravailleAilleurs = 4, Inconnu = -1.OuiOui
DébutdatetimeoffsetHeure de début de l’événement.

Par défaut, l’heure de début est au format UTC. Vous pouvez spécifier un fuseau horaire facultatif dans StartTimeZone, exprimer l’heure de début dans ce fuseau horaire et inclure un décalage par rapport à UTC. Notez que si vous utilisez StartTimeZone, vous devez spécifier une valeur pour EndTimeZone également.

Cet exemple indique 25 février 2015, 19:34 au format PST : « 2015-02-25T19:34:00-08:00 ».
OuiOui
StartTimeZoneChaîneIdentifie le fuseau horaire de la réunion pour l’heure de début de la réunion (voir la propriété Start). Cette propriété fait en sorte que le service gère les changements de fuseau horaire à la place du client. Cette propriété est définie avec le nom du fuseau horaire tel qu’il est stocké dans Windows. Vous pouvez obtenir les noms des fuseaux horaires en appelant System.TimeZoneInfo.GetSystemTimeZones().

Cette propriété est facultative pour v1.0. Toutefois, cette propriété doit être utilisée si la propriété EndTimeZone est utilisée.

Un exemple de valeur pour cette propriété est « Pacific Standard Time ». Voir Fuseau horaire pour plus d’informations.
OuiNon
SubjectChaîneTexte de la ligne d’objet de l’événement.OuiOui
TypeEventTypeType d’événement : InstanceUnique = 0, Occurrence = 1, Exception = 2, MaîtreSérie = 3.OuiOui
WebLinkChaîneURL permettant d’ouvrir l’événement dans Outlook Web App.

L’événement 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.

Cette URL est accessible à partir d’un iFrame.
NonNon

EventMessage

Un message qui représente une demande de réunion, un message d’annulation de réunion, un message d’acceptation de réunion, un message d’acceptation provisoire de réunion ou un message de refus de réunion.

Type de base : Message

Une instance EventMessage se trouve généralement dans le dossier Boîte de réception, où elle arrive soit à l’issue de la création d’une réunion par un organisateur d’événement soit à l’issue de la réponse d’un participant à une demande de réunion. Vous agissez sur les messages d’événement de la même façon que vous agissez sur le Message, avec quelques petites différences décrites dans le tableau suivant.

Action/VerbPermissionDescription
Créer un message d’événement (POST)S/ONon autorisé. Se traduira par un code de réponse 400.
Mettre à jour un message d’événement (PATCH)Mail.WriteVous pouvez mettre à jour les propriétés From, Sender, ToRecipients, CcRecipients, BccRecipients, ReplyTo, IsDeliveryReceiptRequested, IsReadReceiptRequested, IsDraft, IsRead, Subject, Body, Importance et Categories.
Supprimer un message d’événement (DELETE)Mail.WriteMême action que pour un Message.
Déplacer un message d’événement (POST)Mail.WriteMême action que pour un Message.
Copier un message d’événement (POST)Mail.WriteMême action que pour un Message.
Créer un brouillon de message de réponse (POST)Mail.WriteMême action que pour un Message.
Créer un brouillon de message de réponse à tous (POST)Mail.WriteMême action que pour un Message.
Créer une réponse (POST)Mail.WriteMême action que pour un Message.
Créer une réponse à tous (POST)Mail.WriteMême action que pour un Message.
Envoyer un message d’événement existant (POST)Mail.WriteVous pouvez uniquement envoyer un message d’événement quand la valeur de la propriété IsDraft est vrai. Une copie du message est enregistrée dans le dossier Éléments envoyés.
Créer un brouillon de message d’événementMail.WriteMême action que pour un Message.
Transférer un message d’événementMail.WriteMême action que pour un Message.

Une instance EventMessage inclut des propriétés du type de base Message et les propriétés dans le tableau suivant.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
EndDateTimeDateTimeTimeZoneDate et heure de fin auxquelles l’événement se termine.OuiOui
ÉvénementÉvénementL’é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.NonNon
IsAllDayBooléenIndique si l’événement dure toute la journée. Ajuster cette propriété nécessite d'ajuster les propriétés StartDateTime et EndDateTime de l’événement également.OuiOui
IsOutOfDateBooléenIndique si cette demande de réunion a été rendue obsolète par une demande plus récente.NonNon
LocationLocationEmplacement de l’événement associé.OuiOui
MeetingMessageTypeMeetingMessageTypeLe type de message d’événement : Aucun = 0, DemandeRéunion = 1, RéunionAnnulée = 2, RéunionAcceptée = 3, RéunionProvisoirementAcceptée = 4, RéunionRefusée = 5NonOui
PériodicitéPatternedRecurrenceModèle de périodicité pour l’événement associé.OuiNon
StartDateTimeDateTimeTimeZoneHeure de début de l’événement associé.OuiOui
TypeEventTypeLe type de l'événement associé : InstanceUnique = 0, Occurrence = 1, Exception = 2, MaîtreSérie = 3.OuiOui
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ÉvénementÉvénementL’é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.NonNon
MeetingMessageTypeMeetingMessageTypeLe type de message d’événement : Aucun = 0, DemandeRéunion = 1, RéunionAnnulée = 2, RéunionAcceptée = 3, RéunionProvisoirementAcceptée = 4, RéunionRefusée = 5NonOui
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ÉvénementÉvénementL’é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.NonNon
MeetingMessageTypeMeetingMessageTypeLe type de message d’événement : Aucun = 0, DemandeRéunion = 1, RéunionAnnulée = 2, RéunionAcceptée = 3, RéunionProvisoirementAcceptée = 4, RéunionRefusée = 5NonOui

EventMessageRequest (preview)

Un message qui représente une demande de réunion.

Type de base : EventMessage

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
PreviousEndDateTimeDateTimeTimeZoneLa date et l’heure de fin précédentes de la réunion demandée.NonOui
PreviousLocationLocationL’emplacement précédent de la réunion demandée.NonOui
PreviousStartDateTimeDateTimeTimeZoneDate et l’heure de début précédentes de la réunion demandée.NonOui

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Propriétés étendues

Vous pouvez créer une propriété personnalisée sur une entité sous la forme d’un objet MultiValueLegacyExtendedProperty ou SingleValueLegacyExtendedProperty, en fonction des valeurs prévues pour la propriété.

MultiValueLegacyExtendedProperty

Une propriété étendue qui peut contenir une collection de plusieurs valeurs.

Type : Microsoft.OutlookServices.MultiValueLegacyExtendedProperty

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ValueCollection(String)Collection de valeurs de propriété.OuiNon
PropertyIdChaîneIdentificateur de la propriété. Il est utilisé pour identifier la propriété.NonNon

SingleValueLegacyExtendedProperty

Propriété étendue qui contient une valeur unique.

Type : Microsoft.OutlookServices.SingleValueLegacyExtendedProperty

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ValueChaîneValeur de la propriétéOuiNon
PropertyIdChaîneIdentificateur de la propriété. Il est utilisé pour identifier la propriété.NonOui

Lors de la création d’une propriété étendue, il existe plusieurs façons de préciser l’élément PropertyId. Voir Formats PropertyId pour plus de détails.

Voir la Référence de l'API REST des propriétés étendues pour les opérations connexes que vous pouvez utiliser.

Vous pouvez créer une propriété personnalisée sur une entité sous la forme d’un objet MultiValueLegacyExtendedProperty ou SingleValueLegacyExtendedProperty, en fonction des valeurs prévues pour la propriété.

MultiValueLegacyExtendedProperty

Une propriété étendue qui peut contenir une collection de plusieurs valeurs.

Type : Microsoft.OutlookServices.MultiValueLegacyExtendedProperty

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ValueCollection(String)Collection de valeurs de propriété.OuiNon
PropertyIdChaîneIdentificateur de la propriété. Il est utilisé pour identifier la propriété.NonNon

SingleValueLegacyExtendedProperty

Propriété étendue qui contient une valeur unique.

Type : Microsoft.OutlookServices.SingleValueLegacyExtendedProperty

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ValueChaîneValeur de la propriétéOuiNon
PropertyIdChaîneIdentificateur de la propriété. Il est utilisé pour identifier la propriété.NonOui

Lors de la création d’une propriété étendue, il existe plusieurs façons de préciser l’élément PropertyId. Voir Formats PropertyId pour plus de détails.

Voir la Référence de l'API REST des propriétés étendues pour les opérations connexes que vous pouvez utiliser.

Cette fonctionnalité est actuellement disponible dans les version bêta et 2.0. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l'article et sélectionnez la version de votre choix.

FileAttachment

Un fichier (tel qu’un fichier texte ou un document Word) associé à un message, un événement ou une tâche. La propriétéContentBytes contient le contenu codé en base64 du fichier. Dérivé de l’entité Attachement.

Type : Microsoft.OutlookServices.FileAttachment

Type de base : Microsoft.OutlookServices.Attachment

PropriétéTypeDescriptionAccessible en écriture ?
ContentBytesbinaireContenu binaire du fichier.Non
ContentIdChaîneID de la pièce jointe dans la banque d’informations Exchange.Non
ContentLocationChaîneURI (Uniform Resource Identifier) qui correspond à l’emplacement du contenu de la pièce jointe.Non
ContentTypeChaîneType de contenu de la pièce jointe.Oui
LastModifiedDateTimedatetimeoffsetDate et heure de la dernière modification de la pièce jointe.Non
IDChaîneID de la pièce jointe.Non
IsInlinebooléenValeur true s’il s’agit d’une pièce jointe incorporée.Oui
NameChaîneNom qui représente le texte qui s’affiche sous l’icône représentant la pièce jointe incorporée. Cela n’est pas obligatoirement le nom du fichier réel.Oui
SizeInt32Taille en octets de la pièce jointe.Non

Un fichier (tel qu’un fichier texte ou un document Word) associé à un message, un événement ou une tâche. La propriétéContentBytes contient le contenu codé en base64 du fichier. Dérivé de l’entité Attachement.

Type : Microsoft.OutlookServices.FileAttachment

Type de base : Microsoft.OutlookServices.Attachment

PropriétéTypeDescriptionAccessible en écriture ?
ContentBytesbinaireContenu binaire du fichier.Non
ContentIdChaîneID de la pièce jointe dans la banque d’informations Exchange.Non
ContentLocationChaîneURI (Uniform Resource Identifier) qui correspond à l’emplacement du contenu de la pièce jointe.Non
ContentTypeChaîneType de contenu de la pièce jointe.Oui
LastModifiedDateTimedatetimeoffsetDate et heure de la dernière modification de la pièce jointe.Non
IDChaîneID de la pièce jointe.Non
IsInlinebooléenValeur true s’il s’agit d’une pièce jointe incorporée.Oui
NameChaîneNom qui représente le texte qui s’affiche sous l’icône représentant la pièce jointe incorporée. Cela n’est pas obligatoirement le nom du fichier réel.Oui
SizeInt32Taille en octets de la pièce jointe.Non

Un fichier (tel qu’un fichier texte ou un document Word) associé à un message ou un événement. La propriétéContentBytes contient le contenu codé en base64 du fichier. Dérivé de l’entité Attachement.

Type : Microsoft.OutlookServices.FileAttachment

Type de base : Microsoft.OutlookServices.Attachment

PropriétéTypeDescriptionAccessible en écriture ?
ContentBytesbinaireContenu binaire du fichier.Non
ContentIdChaîneID de la pièce jointe dans la banque d’informations Exchange.Non
ContentLocationChaîneURI (Uniform Resource Identifier) qui correspond à l’emplacement du contenu de la pièce jointe.Non
ContentTypeChaîneType de contenu de la pièce jointe.Oui
DateTimeLastModifieddatetimeoffsetDate et heure de la dernière modification de la pièce jointe.Non
IDChaîneID de la pièce jointe.Non
IsContactPhotobooléenObsolète.Oui
IsInlinebooléenValeur true s’il s’agit d’une pièce jointe incorporée.Oui
NameChaîneNom qui représente le texte qui s’affiche sous l’icône représentant la pièce jointe incorporée. Cela n’est pas obligatoirement le nom du fichier réel.Oui
SizeInt32Taille en octets de la pièce jointe.Non

Folder / MailFolder

Remarque Dans la version bêta, l'entité et le type précédemment connu sous le nom Folder ont été renommés en MailFolder.

Un dossier dans la boîte aux lettres d’un utilisateur, tel que Boîte de réception, Brouillons et Éléments envoyés. Les dossiers peuvent contenir des messages et d'autres dossiers.

Type : Microsoft.OutlookServices.MailFolder

Une collection MailFolders renvoie un tableau de dossiers dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/folders/$count

Voir Opérations sur les dossiers pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChildFolderCountInt32Le nombre de dossiers dans le dossier.NonOui
ChildFoldersCollection(MailFolder)Collection de dossiers enfants dans le dossier. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage du dossier.OuiOui
IDChaîneIdentificateur unique du dossier. Vous pouvez utiliser les noms connus suivants pour accéder au dossier correspondant : Boîte de réception, Brouillons, Éléments envoyés, Éléments supprimés.NonNon
MessageRulesCollection(MessageRule)Ensemble de règles qui s’appliquent au dossier de boîte de réception. Propriété de navigation.NonNon
MessagesCollection(Message)La collection de messages dans le dossier. Propriété de navigation.NonNon
ParentFolderIdChaîneIdentificateur unique du dossier parent du dossierNonNon
TotalItemCountInt32Le nombre d’éléments dans le dossier.NonOui
UnreadItemCountInt32Nombre d’éléments inclus dans le dossier marqués comme non lus.NonOui
WellKnownNameChaîneLe nom connu du dossier, tel que clutter, deleteditems, drafts, inbox, junkemail, outbox, ou sentitems.NonOui
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui

Accéder efficacement aux nombres d’éléments

Les propriétés TotalItemCount et UnreadItemCount d’un dossier vous permettent de calculer facilement le nombre d’éléments lus dans le dossier.
Elles vous permettent d’éviter les requêtes qui peuvent entraîner une latence importante, telles que la suivante :

https://outlook.office.com/api/beta/me/mailfolders/inbox/messages?$count=true&$filter=isread%20eq%20false

Les dossiers dans Outlook peuvent contenir plusieurs types d'éléments. Par exemple, la boîte de réception peut contenir des éléments de demande de réunion qui sont différents des éléments de courrier. Les propriétés TotalItemCount et UnreadItemCount incluent des éléments dans un dossier quels que soient leurs types d'éléments.

Remarque Dans la version 2.0, l’entité et le type précédemment connu sous le nom Folder ont été renommés en MailFolder.

Un dossier dans la boîte aux lettres d’un utilisateur, tel que Boîte de réception, Brouillons et Éléments envoyés. Les dossiers peuvent contenir des messages et d'autres dossiers.

Type : Microsoft.OutlookServices.MailFolder

Une collection MailFolders renvoie un tableau de dossiers dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/folders/$count

Voir Opérations sur les dossiers pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChildFolderCountInt32Le nombre de dossiers dans le dossier.NonOui
ChildFoldersCollection(MailFolder)Collection de dossiers enfants dans le dossier. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage du dossier.OuiOui
IDChaîneIdentificateur unique du dossier. Vous pouvez utiliser les noms connus suivants pour accéder au dossier correspondant : Boîte de réception, Brouillons, Éléments envoyés, Éléments supprimés.NonNon
MessagesCollection(Message)La collection de messages dans le dossier. Propriété de navigation.NonNon
ParentFolderIdChaîneIdentificateur unique du dossier parent du dossierNonNon
TotalItemCountInt32Le nombre d’éléments dans le dossier.NonOui
UnreadItemCountInt32Nombre d’éléments inclus dans le dossier marqués comme non lus.NonOui
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOui

Accéder efficacement aux nombres d’éléments

Les propriétés TotalItemCount et UnreadItemCount d’un dossier vous permettent de calculer facilement le nombre d’éléments lus dans le dossier.
Elles vous permettent d’éviter les requêtes qui peuvent entraîner une latence importante, telles que la suivante :

https://outlook.office.com/api/v2.0/me/mailfolders/inbox/messages?$count=true&$filter=isread%20eq%20false

Les dossiers dans Outlook peuvent contenir plusieurs types d'éléments. Par exemple, la boîte de réception peut contenir des éléments de demande de réunion qui sont différents des éléments de courrier. Les propriétés TotalItemCount et UnreadItemCount incluent des éléments dans un dossier quels que soient leurs types d'éléments.

Remarque Dans les versions ultérieures à 1.0, l’entité et le type de Folder ont été renommés en MailFolder.

Un dossier dans la boîte aux lettres d’un utilisateur, tel que Boîte de réception, Brouillons et Éléments envoyés. Les dossiers peuvent contenir des messages et d'autres dossiers.

Type : Microsoft.OutlookServices.Folder

Une collection Folders renvoie un tableau de dossiers dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/folders/$count

Voir Opérations sur les dossiers pour les actions prises en charge.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChildFolderCountInt32Le nombre de dossiers dans le dossier.NonOui
ChildFoldersCollection(Folder)Collection de dossiers enfants dans le dossier. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage du dossier.OuiOui
IDChaîneIdentificateur unique du dossier. Vous pouvez utiliser les noms connus suivants pour accéder au dossier correspondant : Boîte de réception, Brouillons, Éléments envoyés, Éléments supprimés.NonNon
MessagesCollection(Message)La collection de messages dans le dossier. Propriété de navigation.NonNon
ParentFolderIdChaîneIdentificateur unique du dossier parent du dossierNonNon
TotalItemCountInt32Le nombre d’éléments dans le dossier.NonOui
UnreadItemCountInt32Nombre d’éléments inclus dans le dossier marqués comme non lus.NonOui

Accéder efficacement aux nombres d’éléments

Les propriétés TotalItemCount et UnreadItemCount d’un dossier vous permettent de calculer facilement le nombre d’éléments lus dans le dossier.
Elles vous permettent d’éviter les requêtes qui peuvent entraîner une latence importante, telles que la suivante :

https://outlook.office.com/api/v1.0/me/folders/inbox/messages?$count=true&$filter=isread%20eq%20false

Les dossiers dans Outlook peuvent contenir plusieurs types d'éléments. Par exemple, la boîte de réception peut contenir des éléments de demande de réunion qui sont différents des éléments de courrier. Les propriétés TotalItemCount et UnreadItemCount incluent des éléments dans un dossier quels que soient leurs types d'éléments.

InferenceClassification

Classification des messages d’un utilisateur pour mettre en évidence ceux qui sont les plus pertinents ou les plus importants pour l’utilisateur.

Type : Microsoft.OutlookServices.InferenceClassification

PropriétéTypeDescriptionAccessible en écriture ?
RemplacementsCollection(InferenceClassificationOverride)Ensemble de remplacements permettant à un utilisateur de toujours classer d’une certaine façon les messages provenant d’expéditeurs spécifiques, comme pris en charge par InferenceClassificationType. Propriété de navigation.Oui

Classification des messages d’un utilisateur pour mettre en évidence ceux qui sont les plus pertinents ou les plus importants pour l’utilisateur.

Type : Microsoft.OutlookServices.InferenceClassification

PropriétéTypeDescriptionAccessible en écriture ?
RemplacementsCollection(InferenceClassificationOverride)Ensemble de remplacements permettant à un utilisateur de toujours classer d’une certaine façon les messages provenant d’expéditeurs spécifiques, comme pris en charge par InferenceClassificationType. Propriété de navigation.Oui

Cette fonctionnalité est actuellement disponible dans les versions v2.0 et bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez l’une de ces versions.

InferenceClassificationOverride

Représente les remplacements d’un utilisateur sur la manière dont les messages entrants provenant d’un expéditeur spécifique doivent toujours être classés.

Type : Microsoft.OutlookServices.InferenceClassificationOverride

PropriétéTypeDescriptionAccessible en écriture ?
ClassifyAsInferenceClassificationTypeSpécifie la manière dont les messages entrants provenant d’un expéditeur spécifique doivent toujours être classés. Éléments ciblés = 0, Autre = 1.Oui
IDChaîneIdentificateur unique du remplacement.Non
SenderEmailAddressEmailAddressInformations d’adresse de messagerie de l’expéditeur pour lesquels le remplacement est créé.Oui

Représente les remplacements d’un utilisateur sur la manière dont les messages entrants provenant d’un expéditeur spécifique doivent toujours être classés.

Type : Microsoft.OutlookServices.InferenceClassificationOverride

PropriétéTypeDescriptionAccessible en écriture ?
ClassifyAsInferenceClassificationTypeSpécifie la manière dont les messages entrants provenant d’un expéditeur spécifique doivent toujours être classés. Éléments ciblés = 0, Autre = 1.Oui
IDChaîneIdentificateur unique du remplacement.Non
SenderEmailAddressEmailAddressAdresse de messagerie de l’expéditeur pour lesquels le remplacement est créé.Oui

Cette fonctionnalité est actuellement disponible dans les versions v2.0 et bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez l’une de ces versions.

ItemAttachment

Un message, un contact ou un événement associé à un autre message, événement ou tâche. Dérivé de l’entité Attachement.

Type : Microsoft.OutlookServices.ItemAttachment

Type de base : Microsoft.OutlookServices.Attachment

PropriétéTypeDescriptionAccessible en écriture ?
ContentTypeChaîneType de contenu de la pièce jointe.Oui
LastModifiedDateTimedatetimeoffsetDate et heure de la dernière modification de la pièce jointe.Non
IDChaîneID de la pièce jointe.Non
ÉlémentÉlémentLe message ou l’événement joint. Propriété de navigation.Oui
IsInlinebooléenValeur true si la pièce jointe est incluse, par exemple une image incorporée dans le corps de l’élément.Oui
NameChaîneNom d’affichage de la pièce jointe.Oui
SizeInt32Taille en octets de la pièce jointe.Oui

Un message, un contact ou un événement associé à un autre message, événement ou tâche. Dérivé de l’entité Attachement.

Type : Microsoft.OutlookServices.ItemAttachment

Type de base : Microsoft.OutlookServices.Attachment

PropriétéTypeDescriptionAccessible en écriture ?
ContentTypeChaîneType de contenu de la pièce jointe.Oui
LastModifiedDateTimedatetimeoffsetDate et heure de la dernière modification de la pièce jointe.Non
IDChaîneID de la pièce jointe.Non
ÉlémentÉlémentLe message ou l’événement joint. Propriété de navigation.Oui
IsInlinebooléenValeur true si la pièce jointe est incluse, par exemple une image incorporée dans le corps de l’élément.Oui
NameChaîneNom d’affichage de la pièce jointe.Oui
SizeInt32Taille en octets de la pièce jointe.Oui

Un message, un contact ou un événement associé à un autre message ou un événement. Dérivé de l’entité Attachement.

Type : Microsoft.OutlookServices.ItemAttachment

Type de base : Microsoft.OutlookServices.Attachment

PropriétéTypeDescriptionAccessible en écriture ?
ContentTypeChaîneType de contenu de la pièce jointe.Oui
DateTimeLastModifieddatetimeoffsetDate et heure de la dernière modification de la pièce jointe.Non
IDChaîneID de la pièce jointe.Non
ÉlémentÉlémentLe message ou l’événement joint. Propriété de navigation.Oui
IsInlinebooléenValeur true si la pièce jointe est incluse, par exemple une image incorporée dans le corps de l’élément.Oui
NameChaîneNom d’affichage de la pièce jointe.Oui
SizeInt32Taille en octets de la pièce jointe.Oui

Mention (aperçu)

Représente une notification à une personne en fonction de son adresse e-mail. Ce type de notifications est également connu sous le nom de @-mentions.

La ressource Message prend en charge Mention. Il comprend une propriété MentionsPreview qui indique si l’utilisateur connecté est mentionné dans cette instance et la propriété de navigation Mentions qui prend en charge l’obtention de détails de toute mention dans cette instance.

Lors de la création d’un message, une application peut créer une mention dans la même POSTdemande en incluant la mention dans la propriété Mentions. En utilisant une GET demande avec le $filter paramètre de requête, une application peut renvoyer tous les messages dans la boîte aux lettres de l’utilisateur connecté qui mentionnent l’utilisateur. Une GET demande avec le $expand paramètre de requête permet à l’application de développer toutes les mentions dans un message spécifique.

Ce mécanisme consistant à laisser une application définir et obtenir des mentions dans les messages permet d’obtenir des notifications légères, où l’utilisateur qui fait la mention peut rester dans le contexte existant (comme la composition d’un corps de message) pendant que l’application définit la propriété Mentions sous-jacente. Les personnes mentionnées peuvent facilement savoir si et où elles sont mentionnées à l’aide de demandes GET avec le $filter ou du paramètre de requête $expand.

Un cas d'utilisation de l’API Mentions est dans Outlook, le client de messagerie. Lorsqu’un utilisateur tape @ lors de la rédaction d'un message, Outlook permet simplement à l’utilisateur de sélectionner ou d’entrer un nom pour compléter la commande @-mention, sans avoir à sortir du contexte pour attirer l’attention de la personne. En arrière-plan, Outlook définit la propriété Mentions avant de créer et d’envoyer le message. Outlook utilise également les opérations GET avec $filter et $expand pour permettre à l’utilisateur connecté de rechercher facilement si et quels messages mentionnent l’utilisateur, alertant l’utilisateur des actions ou des discussions pour susciter une réponse plus rapide de leur part.

Type : Microsoft.OutlookServices.Mention

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ApplicationChaîneNom de l’application où la mention est créée. Facultatif. Non utilisé et avec zéro comme valeur par défaut pour Message.OuiNon
ClientReferenceChaîneIdentificateur unique représentant un parent de l’instance de ressource. Facultatif. Non utilisé et avec zéro comme valeur par défaut pour Message.OuiOui
CreatedByEmailAddressInformations d’e-mail de l’utilisateur qui ont réalisé la mention. Obligatoire.OuiNon
CreatedDateTimeDateTimeOffsetDate et heure auxquelles la mention est créée sur le client.NonNon
DeepLinkChaîneLien Web profond vers le contexte de la mention dans l'instance de ressource. Facultatif. Non utilisé et avec zéro comme valeur par défaut pour Message.OuiNon
IDChaîneIdentifiant unique d’une mention dans une instance de ressource.NonNon
MentionnéEmailAddressE-mail d'informations de la personne mentionnée. Obligatoire.OuiNon
MentionTextChaîneContenu pour la mention. Facultatif. Non utilisé et avec zéro comme valeur par défaut pour Message.OuiNon
ServerCreatedDateTimeDateTimeOffsetDate et heure auxquelles la mention est créée sur le serveur. Facultatif. Non utilisé et avec zéro comme valeur par défaut pour Message.NonNon

Cette fonctionnalité est actuellement disponible uniquement en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Cette fonctionnalité est actuellement disponible uniquement en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Message

Message dans un dossier de boîte aux lettres.

Type : Microsoft.OutlookServices.Message

Une collection Message renvoie un tableau de messages dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/messages/$count

Voir Opérations de message pour les actions prises en charge.

PropriétéTypeDescriptionModifiable ?Filtrable ?Consultable ?
AttachmentsCollection(Attachment)Pièces jointes fileAttachment et itemAttachment du message. Propriété de navigation.OuiNonOui
BccRecipientsCollection (Recipient)Destinataires Cci du message.OuiNonOui
BodyItemBodyCorps du message.OuiNonPar défaut
BodyPreviewChaîneLes 255 premiers caractères du contenu du corps du message.NonNonOui
CatégoriesCollection (String)Catégories associées au message.OuiOuiOui
CcRecipientsCollection (Recipient)Destinataires Cc du message.OuiNonOui
ChangeKeyChaîneVersion du message.NonNonNon
ConversationIdChaîneIdentificateur de la conversation à laquelle appartient l’e-mail.NonOuiNon
ConversationIndexBinaireIndique la position relative de l’élément dans la conversation à laquelle appartient l’e-mail.NonNonNon
CreatedDateTimedatetimeoffsetDate et heure de la création du message.NonOuiNon
ExtensionsCollection(Extension)Collection des extensions de données de type ouvert définie pour le message. Propriété de navigation.NonOuiNon
IndicateurFollowupFlagInformations sur tout suivi du message.OuiOuiOui
FromDestinatairePropriétaire de la boîte aux lettres et expéditeur du message.OuiOuiOui
HasAttachmentsbooléenIndique si le message contient des pièces jointes.NonOuiOui
IDChaîneIdentificateur unique du message.NonNonNon
ImportanceImportanceImportance du message : Faible = 0, Normale = 1, Élevée = 2.OuiOuiOui
InferenceClassificationInferenceClassificationTypeClassement du message de l’utilisateur, en fonction de l’importance ou de la pertinence déduite, ou d’un remplacement explicite.OuiOuiNon
InternetMessageIdChaîneID du message au format spécifié par RFC2822.NonNonNon
InternetMessageHeadersCollection(InternetMessageHeader)La collecte des en-têtes de message Internet dans le format spécifié par la norme RFC2822.NonNonNon
IsDeliveryReceiptRequestedbooléenIndique si une confirmation de lecture est demandée pour le message.OuiOuiNon
IsDraftbooléenIndique si le message est un brouillon. Un message est un brouillon s’il n’a pas encore été envoyé.NonOuiNon
IsReadbooléenIndique si le message a été lu.OuiOuiNon
IsReadReceiptRequestedbooléenIndique si une confirmation de lecture est demandée pour le message.OuiOuiNon
LastModifiedDateTimedatetimeoffsetDate et heure de la dernière modification du message.NonOuiNon
MentionsCollection (Mention)Une collection de mentions dans le message, classée par la propriétéCreatedDateTime du plus récent au plus ancien. Par défaut, un message GET ne renvoie pas cette propriété sauf si vous appliquez $expand sur la propriété. Propriété de navigation.OuiNonNon
MentionsPreviewMentionsPreviewInformations sur les mentions dans le message. Lors du traitement d'une requête GET /messages, le serveur définit cette propriété et l’inclut dans la réponse par défaut. Le serveur renvoie null s’il n'y a pas de mentions dans le message. Facultatif.NonNonNon
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOuiNon
ParentFolderIdChaîneIdentificateur unique du dossier parent du message.NonNonNon
ReceivedDateTimedatetimeoffsetDate et heure de réception du message.NonOuiOui
ReplyToCollection (Recipient)Adresses e-mail à utiliser lors de la réponse.NonNonNon
SenderDestinataireCompte réellement utilisé pour générer le message.OuiOuiPar défaut
SentDateTimedatetimeoffsetDate et heure d’envoi du message.NonOuiNon
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOuiNon
SubjectChaîneObjet du message.OuiOuiPar défaut
ToRecipientsCollection (Recipient)Destinataires À du message.OuiNonOui
UniqueBodyItemBodyLe corps du message qui est unique à la conversation.NonNonNon
UnsubscribeDataCollection (String)Ceci contient les entrées valides analysées dans l'en-tête List-Unsubscribe. Si la propriété UnsubscribeEnabled est true, cela contiendrait les données pour la commande mailto: commande dans l'en-tête List-Unsubscribe. Les données doivent être conformes à la norme RFC-2369. Utilisez l’action Se désabonner pour empêcher que des messages ultérieurs soient envoyés à la liste de distribution correspondante.NonNonNon
UnsubscribeEnabledbooléenIndique si ce message permet à un destinataire de se désabonner et d’empêcher que des messages ultérieurs soient envoyés en fonction d’une liste de distribution d’e-mails. True si la List-Unsubscribe l'en-tête est conforme à la norme RFC-2369.NonNonNon
WebLinkChaîneURL permettant d’ouvrir le message dans 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.

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.

Cette URL est accessible à partir d’un iFrame.
NonOuiNon
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?Consultable ?
AttachmentsCollection(Attachment)Pièces jointes fileAttachment et itemAttachment du message. Propriété de navigation.OuiNonOui
BccRecipientsCollection (Recipient)Destinataires Cci du message.OuiNonOui
BodyItemBodyCorps du message.OuiNonPar défaut
BodyPreviewChaîneLes 255 premiers caractères du contenu du corps du message.NonNonOui
CatégoriesCollection (String)Catégories associées au message.OuiOuiOui
CcRecipientsCollection (Recipient)Destinataires Cc du message.OuiNonOui
ChangeKeyChaîneVersion du message.NonNonNon
ConversationIdChaîneID de la conversation à laquelle appartient l’e-mail.NonOuiNon
CreatedDateTimedatetimeoffsetDate et heure de la création du message.NonOuiNon
ExtensionsCollection(Extension)Collection des extensions de données de type ouvert définie pour le message. Propriété de navigation.NonOuiNon
FromDestinatairePropriétaire de la boîte aux lettres et expéditeur du message.OuiOuiOui
HasAttachmentsbooléenIndique si le message contient des pièces jointes.NonOuiOui
IDChaîneIdentificateur unique du message.NonNonNon
ImportanceImportanceImportance du message : Faible = 0, Normale = 1, Élevée = 2.OuiOuiOui
InferenceClassificationInferenceClassificationTypeClassement du message de l’utilisateur, en fonction de l’importance ou de la pertinence déduite, ou d’un remplacement explicite.OuiOuiOui
IsDeliveryReceiptRequestedbooléenIndique si une confirmation de lecture est demandée pour le message.OuiOuiNon
IsDraftbooléenIndique si le message est un brouillon. Un message est un brouillon s’il n’a pas encore été envoyé.NonOuiNon
IsReadbooléenIndique si le message a été lu.OuiOuiNon
IsReadReceiptRequestedbooléenIndique si une confirmation de lecture est demandée pour le message.OuiOuiNon
LastModifiedDateTimedatetimeoffsetDate et heure de la dernière modification du message.NonOuiNon
MultiValueExtendedPropertiesUne collectionUne collection de propriétés étendues multi-valeur de type MultiValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOuiNon
ParentFolderIdChaîneIdentificateur unique du dossier parent du message.NonNonNon
ReceivedDateTimedatetimeoffsetDate et heure de réception du message.NonOuiOui
ReplyToCollection (Recipient)Adresses e-mail à utiliser lors de la réponse.NonNonNon
SenderDestinataireCompte réellement utilisé pour générer le message.OuiOuiPar défaut
SingleValueExtendedPropertiesUne collectionUne collection de propriétés étendues à valeur unique de type SingleValueLegacyExtendedProperty. Ceci est une propriété de navigation. Trouvez plus d’informations sur les propriétés étendues.OuiOuiNon
SentDateTimedatetimeoffsetDate et heure d’envoi du message.NonOuiNon
SubjectChaîneObjet du message.OuiOuiPar défaut
ToRecipientsCollection (Recipient)Destinataires À du message.OuiNonOui
UniqueBodyItemBodyLe corps du message qui est unique à la conversation.NonNonNon
WebLinkChaîneURL permettant d’ouvrir le message dans 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.

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.

Cette URL est accessible à partir d’un iFrame.
NonOuiNon
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?Consultable ?
AttachmentsCollection(Attachment)Pièces jointes fileAttachment et itemAttachment du message. Propriété de navigation.OuiNonOui
BccRecipientsCollection (Recipient)Destinataires Cci du message.OuiNonOui
BodyItemBodyCorps du message.OuiNonPar défaut
BodyPreviewChaîneLes 255 premiers caractères du contenu du corps du message.NonNonOui
CatégoriesCollection (String)Catégories associées au message.OuiOuiOui
CcRecipientsCollection (Recipient)Destinataires Cc du message.OuiNonOui
ChangeKeyChaîneVersion du message.NonNonNon
ConversationIdChaîneID de la conversation à laquelle appartient l’e-mail.NonOuiNon
DateTimeCreateddatetimeoffsetDate et heure de la création du message.NonOuiNon
DateTimeLastModifieddatetimeoffsetDate et heure de la dernière modification du message.NonOuiNon
DateTimeReceiveddatetimeoffsetDate et heure de réception du message.NonOuiOui
DateTimeSentdatetimeoffsetDate et heure d’envoi du message.NonOuiNon
FromDestinatairePropriétaire de la boîte aux lettres et expéditeur du message.OuiOuiOui
HasAttachmentsbooléenIndique si le message contient des pièces jointes.OuiOuiOui
IDChaîneIdentificateur unique du message.NonNonNon
ImportanceImportanceImportance du message : Faible = 0, Normale = 1, Élevée = 2.OuiOuiOui
IsDeliveryReceiptRequestedbooléenIndique si une confirmation de lecture est demandée pour le message.OuiOuiNon
IsDraftbooléenIndique si le message est un brouillon. Un message est un brouillon s’il n’a pas encore été envoyé.NonOuiNon
IsReadbooléenIndique si le message a été lu.OuiOuiNon
IsReadReceiptRequestedbooléenIndique si une confirmation de lecture est demandée pour le message.OuiOuiNon
ParentFolderIdChaîneIdentificateur unique du dossier parent du message.NonNonNon
ReplyToCollection (Recipient)Adresses e-mail à utiliser lors de la réponse.OuiNonNon
SenderDestinataireCompte réellement utilisé pour générer le message.OuiOuiPar défaut
SubjectChaîneObjet du message.OuiOuiPar défaut
ToRecipientsCollection (Recipient)Destinataires À du message.OuiNonOui
UniqueBodyItemBodyLe corps du message qui est unique à la conversation.NonNonNon
WebLinkChaîneURL permettant d’ouvrir le message dans 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.

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.

Cette URL est accessible à partir d’un iFrame.
NonOuiNon

Suppression de script dans la propriété Body

Le corps du message peut avoir le format HTML ou texte. Le corps du message peut être au format HTML ou texte. Si le corps est au format HTML, par défaut, le contenu HTML potentiellement dangereux (par exemple, un code JavaScript) incorporé dans la propriété Body est supprimé avant que le contenu du corps ne soit renvoyé dans une réponse REST.

Pour obtenir le contenu HTML d’origine dans son intégralité, insérez l’en-tête de demande HTTP suivant :

Prefer: outlook.allow-unsafe-html

Définition des propriétés Sender et From

Lors de la composition d’un message, dans la plupart des cas, les propriétés From et ** Sender** représentent le même utilisateur connecté, à moins que l’une d’entre elles soit mise à jour comme décrit dans les scénarios suivants :

  • La propriété From peut être modifiée si l’administrateur Exchange a affecté les droits ** sendAs** de la boîte aux lettres à une partie des autres utilisateurs. L’administrateur peut le faire en sélectionnant les ** autorisations de boîte aux lettres du propriétaire de boîte aux lettres dans le portail de gestion Azure, ou en utilisant le Centre d’administration Exchange ou une cmdlet Add-ADPermission de Windows PowerShell. Ensuite, vous pouvez définir via un programme la propriété **From sur un utilisateur qui possède des droits sendAs pour cette boîte aux lettres.

  • La propriété Sender peut être modifiée si le propriétaire de la boîte aux lettres a délégué à un ou plusieurs utilisateurs la possibilité d’envoyer des messages à partir de cette boîte aux lettres. Le propriétaire de la boîte aux lettres peut déléguer dans Outlook. Lorsqu’un délégué envoie un message au nom du propriétaire de la boîte aux lettres, la propriété Sender est définie sur le compte du délégué et la propriété From demeure le propriétaire de la boîte aux lettres. Au moyen d’un programme, vous pouvez attribuer la propriété ** Sender** à un utilisateur qui a un droit de délégué pour cette boîte aux lettres.

MessageRule (preview)

Règle qui s’applique aux messages dans la boîte de réception d’un utilisateur.

Type : Microsoft.OutlookServices.MessageRule

PropriétéTypeDescriptionAccessible en écriture ?
ActionsMessageRuleActionsActions à effectuer sur un message lorsque les conditions correspondantes sont remplies.Oui
ConditionsMessageRulePredicatesConditions qui, lorsqu’elles sont remplies, déclenchent les actions correspondantes pour cette règle.Oui
DisplayNameChaîneNom d’affichage de la règle.Oui
ExceptionsMessageRulePredicatesReprésente les conditions d’exception de la règle.Oui
HasErrorBooléenIndique si la règle se trouve dans une condition d’erreur.Non
IsEnabledBooléenIndique si la règle peut être appliquée aux messages.Oui
IsReadOnlyBooléenIndique si la règle est accessible en lecture seule. Si oui, elle ne peut pas être modifiée ou supprimée par l’API REST de règles.Oui
SequenceInt32Indique l’ordre dans lequel la règle est exécutée, parmi d’autres règles.Oui

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

OutlookCategory (preview)

Type : Microsoft.OutlookServices.OutlookCategory

Catégorie sous laquelle un utilisateur peut regrouper des éléments Outlook tels que des messages et des événements dans leur boîte aux lettres.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
DisplayNameChaîneUn nom unique pour cette catégorie dans la boîte aux lettres de l’utilisateur.NonOui
ColorCategoryColorConstante prédéfinie qui représente la couleur mappée pour cette catégorie.OuiOui

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Photo

Type : Microsoft.OutlookServices.Photo

Photo accessible depuis Exchange Online. Ce sont des données binaires non encodées en base 64.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
HeightentierHauteur de la photoNonNon
IDChaîneIdentificateur unique de la photo.NonNon
LargeurentierLargeur de la photo.NonNon

Type : Microsoft.OutlookServices.Photo

Photo accessible depuis Exchange Online. Ce sont des données binaires non encodées en base 64.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
HeightentierHauteur de la photoNonNon
IDChaîneIdentificateur unique de la photo.NonNon
LargeurentierLargeur de la photo.NonNon

Cette fonctionnalité est actuellement disponible dans les versions v2.0 et bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez l’une de ces versions.

ReferenceAttachment

Type : Microsoft.OutlookServices.ReferenceAttachment

Type de base : Microsoft.OutlookServices.Attachment

Lien vers un fichier ou un dossier joint à un message, un événement ou une tâche. Les emplacements possibles pour le fichier ou le dossier incluent OneDrive, OneDrive Entreprise et DropBox. Dérivé de l’entité Attachement.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ContentTypeChaîneLe type MIME de la pièce jointe. Facultatif.OuiNon
IDChaîneIdentificateur unique de la pièce jointe de référence.NonNon
IsFolderBooléenIndique si la pièce jointe est un lien vers un dossier. Il doit être défini sur vrai si SourceUrl est un lien vers un dossier. Facultatif.OuiNon
IsInlineBooléentrue , s’il s’agit d’une pièce jointe incorporée ; sinon, false. Facultatif.OuiOui
LastModifiedDateTimeDateTimeOffsetDate et heure de la dernière modification de la pièce jointe. La date et l'heure utilisent le format ISO 8601 et sont toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : « 2014-01-01T00:00:00Z ». Facultatif.NonOui
NameChaîneNom d’affichage de la pièce jointe. Cela n'a pas besoin d'être le nom de fichier réel. Obligatoire.OuiOui
PermissionReferenceAttachmentPermissionsSpécifie les autorisations accordées pour la pièce jointe par le type de fournisseur dans ProviderType. Les valeurs possibles sont les suivantes : Other, View, Edit, AnonymousView, AnonymousEdit, OrganizationView et OrganizationEdit. Facultatif.OuiNon
PreviewUrlChaîneS’applique uniquement à une pièce jointe de référence d'une image - URL pour obtenir une image d’aperçu. Utiliser ThumbnailUrl et AperçuUrl uniquement quand SourceUrl identifie un fichier image. Facultatif.OuiNon
ProviderTypeReferenceAttachmentProvidersLe type de fournisseur qui prend en charge une pièce jointe de cette propriété ContentType. Les valeurs possibles sont les suivantes : Other, OneDriveBusiness, OneDriveConsumer et Dropbox. Facultatif.OuiOui
SizeInt32Longueur de la pièce jointe en octets. Facultatif.NonNon
SourceUrlChaîneURL permettant d’obtenir le contenu de la pièce jointe. S'il s'agit d'une URL vers un dossier, pour que le dossier s'affiche correctement dans Outlook ou Outlook sur le Web, définissez la valeur IsFolder à vrai. Obligatoire.OuiNon
ThumbnailUrlChaîneS’applique uniquement à une pièce jointe de référence d'une image - URL pour obtenir une image de miniature. Utiliser ThumbnailUrl et AperçuUrl uniquement quand SourceUrl identifie un fichier image. Facultatif.OuiNon

Type : Microsoft.OutlookServices.ReferenceAttachment

Type de base : Microsoft.OutlookServices.Attachment

Lien vers un fichier ou un dossier joint à un message, un événement ou une tâche. Les emplacements possibles pour le fichier ou le dossier incluent OneDrive, OneDrive Entreprise et DropBox. Dérivé de l’entité Attachement.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ContentTypeChaîneLe type MIME de la pièce jointe. Facultatif.OuiNon
IDChaîneIdentificateur unique de la pièce jointe de référence.NonNon
IsFolderBooléenIndique si la pièce jointe est un lien vers un dossier. Il doit être défini sur vrai si SourceUrl est un lien vers un dossier. Facultatif.OuiNon
IsInlineBooléentrue , s’il s’agit d’une pièce jointe incorporée ; sinon, false. Facultatif.OuiOui
LastModifiedDateTimeDateTimeOffsetDate et heure de la dernière modification de la pièce jointe. La date et l'heure utilisent le format ISO 8601 et sont toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : « 2014-01-01T00:00:00Z ». Facultatif.NonOui
NameChaîneNom d’affichage de la pièce jointe. Cela n'a pas besoin d'être le nom de fichier réel. Obligatoire.OuiOui
PermissionReferenceAttachmentPermissionsSpécifie les autorisations accordées pour la pièce jointe par le type de fournisseur dans ProviderType. Les valeurs possibles sont les suivantes : Other, View, Edit, AnonymousView, AnonymousEdit, OrganizationView et OrganizationEdit. Facultatif.OuiNon
PreviewUrlChaîneS’applique uniquement à une pièce jointe de référence d'une image - URL pour obtenir une image d’aperçu. Utiliser ThumbnailUrl et AperçuUrl uniquement quand SourceUrl identifie un fichier image. Facultatif.OuiNon
ProviderTypeReferenceAttachmentProvidersLe type de fournisseur qui prend en charge une pièce jointe de cette propriété ContentType. Les valeurs possibles sont les suivantes : Other, OneDriveBusiness, OneDriveConsumer et Dropbox. Facultatif.OuiOui
SizeInt32Longueur de la pièce jointe en octets. Facultatif.NonNon
SourceUrlChaîneURL permettant d’obtenir le contenu de la pièce jointe. S'il s'agit d'une URL vers un dossier, pour que le dossier s'affiche correctement dans Outlook ou Outlook sur le Web, définissez la valeur IsFolder à vrai. Obligatoire.OuiNon
ThumbnailUrlChaîneS’applique uniquement à une pièce jointe de référence d'une image - URL pour obtenir une image de miniature. Utiliser ThumbnailUrl et AperçuUrl uniquement quand SourceUrl identifie un fichier image. Facultatif.OuiNon

Cette fonctionnalité est actuellement disponible en version bêta. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez bêta.

Tâche

Type : Microsoft.OutlookServices.Task

Un élément Outlook qui peut suivre un élément de travail. Vous pouvez utiliser une tâche pour suivre le début, les dates et heures d'exécution réelles et échues, sa progression ou son état, si elle est récurrente et nécessite un rappel.

Remarque

Pour chacune des propriétés suivantes liées à la date :

  • CompletedDateTime
  • CreatedDateTime
  • DueDateTime
  • LastModifiedDateTime
  • ReminderDateTime
  • StartDateTime

Si la propriété est définie, l'API REST de la tâche la renvoie par défaut au format UTC dans une réponse REST. Trouvez plus d'informations sur la définition de StartDateTime et de DueDateTime, et sur le renvoi les propriétés liées à la date dans un fuseau horaire personnalisé.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AssignedToChaîneLe nom de la personne à qui la tâche a été assignée.NonOui
AttachmentsCollection(Attachment)La collection des pièces jointes FileAttachment, ItemAttachment, et ReferenceAttachment pour l’événement. Propriété de navigation.NonNon
BodyItemBodyCorps de la tâche qui contient généralement des informations sur la tâche. Notez que seul le type HTML est pris en charge.OuiNon
CatégoriesCollection(String)Catégories associées à la tâche.OuiOui
ChangeKeyChaîneVersion de la tâche.NonNon
CompletedDateTimeDateTimeTimeZoneDate dans le fuseau horaire spécifié à laquelle la tâche a été terminée.OuiOui
CreatedDateTimeDateTimeOffsetDate et heure de création de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande.NonOui
DueDateTimeDateTimeTimeZoneDate dans le fuseau horaire spécifié à laquelle la tâche doit être terminée.OuiOui
HasAttachmentsbooléenValeur True si la tâche comporte des pièces jointes.NonOui
IDChaîneIdentificateur unique de la tâche.NonNon
ImportanceImportanceImportance de l’événement : Low, Normal, High.OuiOui
IsReminderOnbooléenValeur True si une alerte est définie pour rappeler la tâche à l’utilisateur.OuiNon
LastModifiedDateTimeDateTimeOffsetDate et heure de la dernière modification de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande.NonOui
OwnerChaîneNom de la personne qui a créé la tâche.NonOui
ParentFolderIdChaîneIdentificateur unique du dossier parent de la tâche.NonNon
PériodicitéPatternedRecurrencePériodicité de la tâche.OuiNon
ReminderDateTimeDateTimeTimeZoneDate et heure d’une alerte de rappel de la tâche qui doit se produire.OuiNon
Critère de diffusionCritère de diffusionIndique le niveau de confidentialité de l’événement : Normal, Personal, Private, Confidential.OuiOui
StartDateTimeDateTimeTimeZoneDate dans le fuseau horaire spécifié à laquelle la tâche doit commencer.OuiOui
ÉtatTaskStatusIndique l’état ou la progression de la tâche : NotStarted, InProgress, Completed, WaitingOnOthers, Deferred.OuiOui
SubjectChaîneBrève description ou intitulé de la tâche.OuiOui

Type : Microsoft.OutlookServices.Task

Un élément Outlook qui peut suivre un élément de travail. Vous pouvez utiliser une tâche pour suivre le début, les dates et heures d'exécution réelles et échues, sa progression ou son état, si elle est récurrente et nécessite un rappel.

Remarque

Pour chacune des propriétés suivantes liées à la date :

  • CompletedDateTime
  • CreatedDateTime
  • DueDateTime
  • LastModifiedDateTime
  • ReminderDateTime
  • StartDateTime

Si la propriété est définie, l'API REST de la tâche la renvoie par défaut au format UTC dans une réponse REST. Trouvez plus d'informations sur la définition de StartDateTime et de DueDateTime, et sur le renvoi les propriétés liées à la date dans un fuseau horaire personnalisé.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AssignedToChaîneLe nom de la personne à qui la tâche a été assignée.NonOui
AttachmentsCollection(Attachment)La collection des pièces jointes FileAttachment et ItemAttachment pour l’événement. Propriété de navigation.NonNon
BodyItemBodyCorps de la tâche qui contient généralement des informations sur la tâche. Notez que seul le type HTML est pris en charge.OuiNon
CatégoriesCollection(String)Catégories associées à la tâche.OuiOui
ChangeKeyChaîneVersion de la tâche.NonNon
CompletedDateTimeDateTimeTimeZoneDate dans le fuseau horaire spécifié à laquelle la tâche a été terminée.OuiOui
CreatedDateTimeDateTimeOffsetDate et heure de création de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande.NonOui
DueDateTimeDateTimeTimeZoneDate dans le fuseau horaire spécifié à laquelle la tâche doit être terminée.OuiOui
HasAttachmentsbooléenValeur True si la tâche comporte des pièces jointes.NonOui
IDChaîneIdentificateur unique de la tâche.NonNon
ImportanceImportanceImportance de l’événement : Low, Normal, High.OuiOui
IsReminderOnbooléenValeur True si une alerte est définie pour rappeler la tâche à l’utilisateur.OuiNon
LastModifiedDateTimeDateTimeOffsetDate et heure de la dernière modification de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande.NonOui
OwnerChaîneNom de la personne qui a créé la tâche.NonOui
ParentFolderIdChaîneIdentificateur unique du dossier parent de la tâche.NonNon
PériodicitéPatternedRecurrencePériodicité de la tâche.OuiNon
ReminderDateTimeDateTimeTimeZoneDate et heure d’une alerte de rappel de la tâche qui doit se produire.OuiNon
Critère de diffusionCritère de diffusionIndique le niveau de confidentialité de l’événement : Normal, Personal, Private, Confidential.OuiOui
StartDateTimeDateTimeTimeZoneDate dans le fuseau horaire spécifié à laquelle la tâche doit commencer.OuiOui
ÉtatTaskStatusIndique l’état ou la progression de la tâche : NotStarted, InProgress, Completed, WaitingOnOthers, Deferred.OuiOui
SubjectChaîneBrève description ou intitulé de la tâche.OuiOui

Cette fonctionnalité est actuellement disponible dans les version bêta et 2.0. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez l’une de ces versions.

TaskFolder

Type : Microsoft.OutlookServices.TaskFolder

Dossier qui contient des tâches. Dans Outlook, le groupe de tâches par défaut, My Tasks, contient un dossier de tâches par défaut, Tasks, pour la boîte aux lettres de l’utilisateur. Vous ne pouvez pas renommer ou supprimer ces groupes de tâches et dossiers par défaut, mais vous pouvez créer des groupes de tâches et des dossiers de tâches supplémentaires.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChangeKeyChaîneVersion du dossier de tâches.NonNon
IDChaîneIdentificateur unique du dossier de tâches.NonNon
IsDefaultFolderBooléenTrue si le dossier est le dossier de tâches par défaut.NonOui
NameChaîneNom du dossier de tâches.OuiOui
ParentGroupKeyEdm.GuidIdentificateur de GUID unique pour le groupe parent du dossier de tâches.NonNon
TâchesCollection(Task)Tâches dans ce dossier de tâches. Propriété de navigation.NonNon

Type : Microsoft.OutlookServices.TaskFolder

Dossier qui contient des tâches. Dans Outlook, le groupe de tâches par défaut, My Tasks, contient un dossier de tâches par défaut, Tasks, pour la boîte aux lettres de l’utilisateur. Vous ne pouvez pas renommer ou supprimer ces groupes de tâches et dossiers par défaut, mais vous pouvez créer des groupes de tâches et des dossiers de tâches supplémentaires.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChangeKeyChaîneVersion du dossier de tâches.NonNon
IDChaîneIdentificateur unique du dossier de tâches.NonNon
IsDefaultFolderBooléenTrue si le dossier est le dossier de tâches par défaut.NonOui
NameChaîneNom du dossier de tâches.OuiOui
ParentGroupKeyEdm.GuidIdentificateur de GUID unique pour le groupe parent du dossier de tâches.NonNon
TâchesCollection(Task)Tâches dans ce dossier de tâches. Propriété de navigation.NonNon

Cette fonctionnalité est actuellement disponible dans les version bêta et 2.0. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez l’une de ces versions.

TaskGroup

Type : Microsoft.OutlookServices.TaskGroup

Groupe de dossiers qui contient des tâches. Dans Outlook, il existe un groupe de tâches par défaut My Tasks que vous ne pouvez pas renommer ou supprimer. Vous pouvez cependant créer des groupes de tâches supplémentaires.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChangeKeyChaîneVersion du groupe de tâches.NonNon
GroupKeyEdm.GuidIdentificateur de GUID unique pour le groupe de tâches.NonNon
IDChaîneIdentificateur unique du groupe de tâches.NonNon
IsDefaultGroupBooléenTrue si le groupe de tâches est le groupe de tâches par défaut.NonOui
NameChaîneNom du groupe de tâches.OuiOui
TaskFoldersCollection(TaskFolder)Dossiers de tâches dans ce groupe de tâches. Propriété de navigation.NonNon

Type : Microsoft.OutlookServices.TaskGroup

Groupe de dossiers qui contient des tâches. Dans Outlook, il existe un groupe de tâches par défaut My Tasks que vous ne pouvez pas renommer ou supprimer. Vous pouvez cependant créer des groupes de tâches supplémentaires.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
ChangeKeyChaîneVersion du groupe de tâches.NonNon
GroupKeyEdm.GuidIdentificateur de GUID unique pour le groupe de tâches.NonNon
IDChaîneIdentificateur unique du groupe de tâches.NonNon
IsDefaultGroupBooléenTrue si le groupe de tâches est le groupe de tâches par défaut.NonOui
NameChaîneNom du groupe de tâches.OuiOui
TaskFoldersCollection(TaskFolder)Dossiers de tâches dans ce groupe de tâches. Propriété de navigation.NonNon

Cette fonctionnalité est actuellement disponible dans les version bêta et 2.0. Pour en savoir plus, utilisez le contrôle dans le coin supérieur droit de l’article et sélectionnez l’une de ces versions.

User

Un utilisateur dans le système. Le point de terminaison Moi est fourni en tant que raccourci pour spécifier l’utilisateur actuel par adresse SMTP ( users/sadie@contoso.com).

Type : Microsoft.OutlookServices.User

Une collection Users renvoie un tableau d’utilisateurs dans la propriété value de la réponse OData. Utilisez $count pour obtenir le nombre d’entités dans la collection : .../me/users/$count

Remarque L’entité User comprend de nombreuses propriétés et relations (propriétés de navigation) qui sont fréquemment étoffées. La section ci-dessous décrit seulement un sous-ensemble. Pour plus d'informations, reportez-vous à la définition User définition dans le fichier de métadonnées correspondant à votre version.

PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AliasChaîneAlias de l’utilisateur Généralement, l’adresse SMTP de l’utilisateur.OuiOui
CalendrierCalendrierCalendrier principal de l’utilisateur. Propriété de navigation.NonNon
CalendarGroupsCollection(CalendarGroup)Groupes de calendriers de l’utilisateur. Propriété de navigation.NonNon
CalendriersCollection(Calendar)Calendriers de l’utilisateur. Propriété de navigation.NonNon
CalendarViewCollection(Event)Affichage Calendrier pour le calendrier. Propriété de navigation.NonNon
ContactFoldersCollection(ContactFolder)Dossiers de contacts de l’utilisateur. Propriété de navigation.NonNon
ContactsCollection(Contact)Contacts de l’utilisateur. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage de l’utilisateur.OuiOui
ÉvénementsCollection(Event)Événements de l’utilisateur. Le comportement par défaut est l’affichage des événements sous le calendrier par défaut. Propriété de navigation.NonNon
IDChaîneIdentificateur unique de l’utilisateur.NonNon
InferenceClassificationInferenceClassificationClassement pertinent des messages de l’utilisateur en fonction des désignations explicites qui remplacent la pertinence ou l’importance déduite. Propriété de navigation.OuiOui
MailboxGuidguidGUID affecté à la boîte aux lettres de l’utilisateur.NonOui
MailboxSettingsMailboxSettingsParamètres de la boîte aux lettres principale de l’utilisateur connecté.OuiNon
MailFoldersCollection(MailFolder)Dossiers dans une boîte aux lettres. Propriété de navigation.NonNon
MasterCategoriesCollection(OutlookCategory)Liste principale des catégories de l’utilisateur. Propriété de navigation.OuiOui
MessagesCollection(Message)Messages dans une boîte aux lettres ou un dossier. Propriété de navigation.NonNon
RootFolderMailFolderDossier racine de la boîte aux lettres de l’utilisateur. Propriété de navigation.NonNon
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AliasChaîneAlias de l’utilisateur Généralement, l’adresse SMTP de l’utilisateur.OuiOui
CalendrierCalendrierCalendrier principal de l’utilisateur. Propriété de navigation.NonNon
CalendarGroupsCollection(CalendarGroup)Groupes de calendriers de l’utilisateur. Propriété de navigation.NonNon
CalendriersCollection(Calendar)Calendriers de l’utilisateur. Propriété de navigation.NonNon
CalendarViewCollection(Event)Affichage Calendrier pour le calendrier. Propriété de navigation.NonNon
ContactFoldersCollection(ContactFolder)Dossiers de contacts de l’utilisateur. Propriété de navigation.NonNon
ContactsCollection(Contact)Contacts de l’utilisateur. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage de l’utilisateur.OuiOui
ÉvénementsCollection(Event)Événements de l’utilisateur. Le comportement par défaut est l’affichage des événements sous le calendrier par défaut. Propriété de navigation.NonNon
IDChaîneIdentificateur unique de l’utilisateur.NonNon
InferenceClassificationInferenceClassificationClassement pertinent des messages de l’utilisateur en fonction des désignations explicites qui remplacent la pertinence ou l’importance déduite. Propriété de navigation.OuiOui
MailboxGuidguidGUID affecté à la boîte aux lettres de l’utilisateur.NonOui
MailboxSettingsMailboxSettingsParamètres de la boîte aux lettres principale de l’utilisateur connecté.OuiNon
MailFoldersCollection(MailFolder)Dossiers dans une boîte aux lettres. Propriété de navigation.NonNon
MessagesCollection(Message)Messages dans une boîte aux lettres ou un dossier. Propriété de navigation.NonNon
RootFolderMailFolderDossier racine de la boîte aux lettres de l’utilisateur. Propriété de navigation.NonNon
PropriétéTypeDescriptionAccessible en écriture ?Filtrable ?
AliasChaîneAlias de l’utilisateur Généralement, l’adresse SMTP de l’utilisateur.OuiOui
CalendrierCalendrierCalendrier principal de l’utilisateur. Propriété de navigation.NonNon
CalendarGroupsCollection(CalendarGroup)Groupes de calendriers de l’utilisateur. Propriété de navigation.NonNon
CalendriersCollection(Calendar)Calendriers de l’utilisateur. Propriété de navigation.NonNon
CalendarViewCollection(Event)Affichage Calendrier pour le calendrier. Propriété de navigation.NonNon
ContactFoldersCollection(ContactFolder)Dossiers de contacts de l’utilisateur. Propriété de navigation.NonNon
ContactsCollection(Contact)Contacts de l’utilisateur. Propriété de navigation.NonNon
DisplayNameChaîneNom d’affichage de l’utilisateur.OuiOui
ÉvénementsCollection(Event)Événements de l’utilisateur. Le comportement par défaut est l’affichage des événements sous le calendrier par défaut. Propriété de navigation.NonNon
FoldersCollection(Folder)Dossiers dans une boîte aux lettres ou un dossier. Propriété de navigation.NonNon
IDChaîneIdentificateur unique de l’utilisateur.NonNon
MailboxGuidguidGUID affecté à la boîte aux lettres de l’utilisateur.NonOui
MessagesCollection(Message)Messages dans une boîte aux lettres ou un dossier. Propriété de navigation.NonNon
RootFolderFolderDossier racine de la boîte aux lettres de l’utilisateur. Propriété de navigation.NonNon

Types complexes

Attendee | AttendeeAvailability | AttendeeBase | AutomaticRepliesMailTips (preview) | AutomaticRepliesSetting | DateTimeTimeZone | EmailAddress | Error (preview) | FollowUpFlag (preview) | GeoCoordinates | InternetMessageHeader (preview) | ItemBody | LocaleInfo | Location | LocationConstraint | LocationConstraintItem | MailboxSettings | MailTips (preview) | MeetingTimeSuggestion | MeetingTimeSuggestionsResult | MentionsPreview (preview) | MessageRuleActions (preview) | MessageRulePredicates (preview) | PatternedRecurrence | Phone (preview) | PhysicalAddress | Recipient | RecurrencePattern | RecurrenceRange | ResponseStatus | SizeRange (preview) | TimeConstraint | TimeSlot | TimeZoneInformation (preview) | Website (preview) | WorkingHours (preview) |

Attendee

Participant de l’événement.

Type : Microsoft.OutlookServices.AttendeeBase

PropriétéTypeDescription
ÉtatResponseStatusLa réponse (aucune, acceptée, refusée, etc.) et l’heure.

AttendeeAvailability

Type et disponibilité d’un participant.

Type : Microsoft.OutlookServices.AttendeeAvailability

PropriétéTypeDescription
AttendeeAttendeeBaseType de participant : que ce soit une personne ou une ressource.
DisponibilitéFreeBusyStatusÉtat de disponibilité du participant.

AttendeeBase

Type de participant.

Type : Microsoft.OutlookServices.Recipient

PropriétéTypeDescription
TypeAttendeeTypeType de participant. Les valeurs possibles sont les suivantes : Required, Optional, Resource. Remarque : si le participant est une personne, FindMeetingTimes considère toujours que la personne est de type Required.

AutomaticRepliesMailTips (preview)

Configuration d'envoi de conseils sur les réponses automatiques dans une boîte aux lettres.

Type : Microsoft.OutlookServices.AutomaticRepliesMailTips

PropriétéTypeDescription
MessageChaîneMessage de réponse automatique.
MessageLanguageLocaleInfoLangue du message de réponse automatique.
ScheduledStartTimeDateTimeTimeZoneDate et heure de début pour les réponses automatiques.
ScheduledEndTimeDateTimeTimeZoneDate et heure de fin définies pour les réponses automatiques.

AutomaticRepliesSetting

Paramètres de configuration pour informer automatiquement l’expéditeur d’un e-mail entrant avec un message de l’utilisateur connecté. Par exemple, une réponse automatique informant que l’utilisateur connecté n’est pas disponible pour répondre aux e-mails.

Type : Microsoft.OutlookServices.AutomaticRepliesSetting

PropriétéTypeDescription
ExternalAudienceExternalAudienceScopeL’ensemble de l’audience externe à l’organisation de l’utilisateur connecté qui recevra l’élément ExternalReplyMessage, si Status est défini sur AlwaysEnabled ou Scheduled. Les valeurs sont None = 0, ContactsOnly = 1, ou All = 2.
ExternalReplyMessageChaîneRéponse automatique à envoyer à l’audience externe spécifiée, si Status est défini sur AlwaysEnabled ou Scheduled.
InternalReplyMessageChaîneRéponse automatique à envoyer à l’audience interne à l’organisation de l’utilisateur connecté, si Status est défini AlwaysEnabled ou Scheduled.
ScheduledEndDateTimeDateTimeTimeZoneDate et heure de fin définies pour les réponses automatiques, si Status est défini sur Scheduled. Vous pouvez définir le fuseau horaire en utilisant Prefer: outlook.timezone l’en-tête HTTP dans l’opération Get.
ScheduledStartDateTimeDateTimeTimeZoneDate et heure de début pour les réponses automatiques, si Status est défini sur Scheduled. Vous pouvez définir le fuseau horaire en utilisant Prefer: outlook.timezone l’en-tête HTTP dans l’opération Get.
ÉtatAutomaticRepliesStatusStatut des configurations pour les réponses automatiques : Disabled = 0, AlwaysEnabled = 1, Scheduled = 2.

Attendee | AttendeeAvailability | AttendeeBase | AutomaticRepliesSetting | DateTimeTimeZone| EmailAddress | GeoCoordinates | ItemBody | LocaleInfo | Location | LocationConstraint | LocationConstraintItem | MailboxSettings | MeetingTimeSuggestion | MeetingTimeSuggestionsResult | PatternedRecurrence | PhysicalAddress | Recipient | RecurrencePattern | RecurrenceRange | ResponseStatus | TimeConstraint | TimeSlot |

Attendee

Participant de l’événement.

Type : Microsoft.OutlookServices.Recipient

PropriétéTypeDescription
ÉtatResponseStatusLa réponse (aucune, acceptée, refusée, etc.) et l’heure.
TypeAttendeeTypeType de participant. Les valeurs possibles sont les suivantes : Required, Optional, Resource.

AttendeeAvailability

Type et disponibilité d’un participant.

Type : Microsoft.OutlookServices.AttendeeAvailability

PropriétéTypeDescription
AttendeeAttendeeBaseType de participant : que ce soit une personne ou une ressource.
DisponibilitéFreeBusyStatusÉtat de disponibilité du participant.

AttendeeBase

Type de participant.

Type : Microsoft.OutlookServices.Recipient

PropriétéTypeDescription
TypeAttendeeTypeType de participant. Les valeurs possibles sont les suivantes : Required, Optional, Resource. Remarque : si le participant est une personne, FindMeetingTimes considère toujours que la personne est de type Required.

AutomaticRepliesSetting

Paramètres de configuration pour informer automatiquement l’expéditeur d’un e-mail entrant avec un message de l’utilisateur connecté. Par exemple, une réponse automatique informant que l’utilisateur connecté n’est pas disponible pour répondre aux e-mails.

Type : Microsoft.OutlookServices.AutomaticRepliesSetting

PropriétéTypeDescription
ExternalAudienceExternalAudienceScopeL’ensemble de l’audience externe à l’organisation de l’utilisateur connecté qui recevra l’élément ExternalReplyMessage, si Status est défini sur AlwaysEnabled ou Scheduled. Les valeurs sont None = 0, ContactsOnly = 1, ou All = 2.
ExternalReplyMessageChaîneRéponse automatique à envoyer à l’audience externe spécifiée, si Status est défini sur AlwaysEnabled ou Scheduled.
InternalReplyMessageChaîneRéponse automatique à envoyer à l’audience interne à l’organisation de l’utilisateur connecté, si Status est défini AlwaysEnabled ou Scheduled.
ScheduledEndDateTimeDateTimeTimeZoneDate et heure de fin définies pour les réponses automatiques, si Status est défini sur Scheduled. Vous pouvez définir le fuseau horaire en utilisant Prefer: outlook.timezone l’en-tête HTTP dans l’opération Get.
ScheduledStartDateTimeDateTimeTimeZoneDate et heure de début pour les réponses automatiques, si Status est défini sur Scheduled. Vous pouvez définir le fuseau horaire en utilisant Prefer: outlook.timezone l’en-tête HTTP dans l’opération Get.
ÉtatAutomaticRepliesStatusStatut des configurations pour les réponses automatiques : Disabled = 0, AlwaysEnabled = 1, Scheduled = 2.

Attendee | EmailAddress | GeoCoordinates | ItemBody | Location | PatternedRecurrence | PhysicalAddress | Recipient | RecurrencePattern | RecurrenceRange | ResponseStatus

Attendee

Participant de l’événement.

Type : Microsoft.OutlookServices.Recipient

PropriétéTypeDescription
ÉtatResponseStatusLa réponse (aucune, acceptée, refusée, etc.) et l’heure.
TypeAttendeeTypeType de participant : Required, Optional, Resource.

DateTimeTimeZone

Décrit la date, heure et fuseau horaire d’un moment.

PropriétéTypeDescription
Date/heureDate/heureMoment unique dans une représentation combinée de la date et de l’heure (<date>T<time>) selon le format ISO 8601.
TimeZoneChaîneL’un des noms des fuseaux horaires suivants.

La propriété TimeZone peut être définie sur l’un des fuseaux horaires pris en charge par Windows, ainsi que sur les noms des fuseaux horaires suivants. Voir Fuseau horaire pour plus d’informations.

Etc/GMT+12

Etc/GMT+11

Pacifique/Honolulu

Amérique/Anchorage

Amérique/Santa_Isabel

Amérique/Los_Angeles

Amérique/Phoenix

Amérique/Chihuahua

Amérique/Denver

Amérique/Guatemala

Amérique/Chicago

Amérique/Mexico_City

Amérique/Regina

Amérique/Bogota

Amérique/New_York

Amérique/Indiana/Indianapolis

Amérique/Caracas

Amérique/Asunción

Amérique/Halifax

Amérique/Cuiaba

Amérique/La_Paz

Amérique/Santiago

Amérique/St_Johns

Amérique/Sao_Paulo

Amérique/Argentine/Buenos_Aires

Amérique/Cayenne

Amérique/Godthab

Amérique/Montevideo

Amérique/Bahia

Etc/GMT+2

Atlantique/Açores

Atlantique/Cape_Verde

Afrique/Casablanca

Etc/GMT

Europe/Londres

Atlantique/Reykjavik

Europe/Berlin

Europe/Budapest

Europe/Paris

Europe/Varsovie

Afrique/Lagos

Afrique/Windhoek

Europe/Bucarest

Asie/Beyrouth

Afrique/Le Caire

Asie/Damas

Afrique/Johannesburg

Europe/Kiev

Europe/Istanbul

Asie/Jérusalem

Asie/Amman

Asie/Bagdad

Europe/Kaliningrad

Asie/Riyad

Afrique/Nairobi

Asie/Téhéran

Asie/Dubaï

Asie/Bakou

Europe/Moscou

Océan indien/Maurice

Asie/Tbilissi

Asie/Erevan

Asie/Kaboul

Asie/Karachi

Asie/Tachkent

Asie/Kolkata

Asie/Colombo

Asie/Katmandou

Asie/Almaty

Asie/Dhaka

Asie/Yekaterinburg

Asie/Rangoon

Asie/Bangkok

Asie/Novossibirsk

Asie/Shanghai

Asie/Krasnoyarsk

Asie/Singapour

Australie/Perth

Asie/Taipei

Asie/Oulan-Bator

Asie/Irkoutsk

Asie/Tokyo

Asie/Séoul

Australie/Adélaïde

Australie/Darwin

Australie/Brisbane

Australie/Sydney

Pacifique/Port_Moresby

Australie/Hobart

Asie/Yakoutsk

Pacifique/Guadalcanal

Asie/Vladivostok

Pacifique/Auckland

Etc/GMT-12

Pacifique/Fidji

Asie/Magadan

Pacifique/Tongatapu

Pacifique/Apia

Pacifique/Kiritimati

DateTimeTimeZone

Décrit la date, heure et fuseau horaire d’un moment.

PropriétéTypeDescription
Date/heureDate/heureMoment unique dans une représentation combinée de la date et de l’heure (<date>T<time>) selon le format ISO 8601.
TimeZoneChaîneL’un des noms des fuseaux horaires suivants.

La propriété TimeZone peut être définie sur l’un des fuseaux horaires pris en charge par Windows, ainsi que sur les noms des fuseaux horaires suivants. Voir Fuseau horaire pour plus d’informations.

Etc/GMT+12

Etc/GMT+11

Pacifique/Honolulu

Amérique/Anchorage

Amérique/Santa_Isabel

Amérique/Los_Angeles

Amérique/Phoenix

Amérique/Chihuahua

Amérique/Denver

Amérique/Guatemala

Amérique/Chicago

Amérique/Mexico_City

Amérique/Regina

Amérique/Bogota

Amérique/New_York

Amérique/Indiana/Indianapolis

Amérique/Caracas

Amérique/Asunción

Amérique/Halifax

Amérique/Cuiaba

Amérique/La_Paz

Amérique/Santiago

Amérique/St_Johns

Amérique/Sao_Paulo

Amérique/Argentine/Buenos_Aires

Amérique/Cayenne

Amérique/Godthab

Amérique/Montevideo

Amérique/Bahia

Etc/GMT+2

Atlantique/Açores

Atlantique/Cape_Verde

Afrique/Casablanca

Etc/GMT

Europe/Londres

Atlantique/Reykjavik

Europe/Berlin

Europe/Budapest

Europe/Paris

Europe/Varsovie

Afrique/Lagos

Afrique/Windhoek

Europe/Bucarest

Asie/Beyrouth

Afrique/Le Caire

Asie/Damas

Afrique/Johannesburg

Europe/Kiev

Europe/Istanbul

Asie/Jérusalem

Asie/Amman

Asie/Bagdad

Europe/Kaliningrad

Asie/Riyad

Afrique/Nairobi

Asie/Téhéran

Asie/Dubaï

Asie/Bakou

Europe/Moscou

Océan indien/Maurice

Asie/Tbilissi

Asie/Erevan

Asie/Kaboul

Asie/Karachi

Asie/Tachkent

Asie/Kolkata

Asie/Colombo

Asie/Katmandou

Asie/Almaty

Asie/Dhaka

Asie/Yekaterinburg

Asie/Rangoon

Asie/Bangkok

Asie/Novossibirsk

Asie/Shanghai

Asie/Krasnoyarsk

Asie/Singapour

Australie/Perth

Asie/Taipei

Asie/Oulan-Bator

Asie/Irkoutsk

Asie/Tokyo

Asie/Séoul

Australie/Adélaïde

Australie/Darwin

Australie/Brisbane

Australie/Sydney

Pacifique/Port_Moresby

Australie/Hobart

Asie/Yakoutsk

Pacifique/Guadalcanal

Asie/Vladivostok

Pacifique/Auckland

Etc/GMT-12

Pacifique/Fidji

Asie/Magadan

Pacifique/Tongatapu

Pacifique/Apia

Pacifique/Kiritimati

EmailAddress

Nom et adresse de messagerie d’un contact ou d’un destinataire de message.

Type : Microsoft.OutlookServices.EmailAddress

PropriétéTypeDescription
NameChaîneNom d’affichage de la personne ou de l’entité.
AddressChaîneAdresse de messagerie de la personne ou de l’entité.
PropriétéTypeDescription
NameChaîneNom d’affichage de la personne ou de l’entité.
AddressChaîneAdresse de messagerie de la personne ou de l’entité.
PropriétéTypeDescription
NameChaîneNom d’affichage de la personne ou de l’entité.
AddressChaîneAdresse de messagerie de la personne ou de l’entité.

Error (preview)

Erreur qui se produit pendant une action.

Type : Microsoft.OutlookServices.Error

PropriétéTypeDescription
MessageChaîneMessage d’erreur.
CodeChaîneCode d’erreur.

FollowUpFlag (preview)

Informations sur le suivi d’une instance de ressource

Type : Microsoft.OutlookServices.FollowupFlag

PropriétéTypeDescription
CompletedDateTimeDateTimeTimeZoneDate et heure de fin du suivi.
DueDateTimeDateTimeTimeZoneDate et heure auxquelles le suivi doit être terminé.
StartDateTimeDateTimeTimeZoneDate et heure auxquelles le suivi doit commencer.
FlagStatusFollowupFlagStatusIndique si l’instance de ressource parente est marquée pour être suivie ou si son suivi est terminé.

GeoCoordinates

Coordonnées géographiques et élévation de la localisation.

Type : Microsoft.OutlookServices.GeoCoordinates

PropriétéTypeDescription
AltitudedoubleAltitude de la localisation.
LatitudedoubleLatitude de la localisation.
LongitudedoubleLongitude de la localisation.
PrécisiondoublePrécision du capteur fournissant la latitude et la longitude.
AltitudeAccuracydoublePrécision du capteur fournissant l’altitude.

InternetMessageHeader (preview)

Paire clé-valeur qui représente un en-tête de message Internet au format défini par RFC2822, qui fournit des détails sur le chemin d’accès réseau adopté par un message pour aller de l’expéditeur au destinataire.

Type : Microsoft.OutlookServices.InternetMessageHeader

PropriétéTypeDescription
NameChaîneClé dans la paire clé-valeur d'en-tête de message Internet.
ValueChaîneCaleur de la paire clé-valeur d'en-tête de message Internet.

ItemBody

Contenu du corps d’un message ou d’un événement.

Type : Microsoft.OutlookServices.ItemBody

PropriétéTypeDescription
ContentTypeBodyTypeType de contenu : Texte = 0, HTML = 1.
ContentChaîneTexte ou contenu HTML.

LocaleInfo

Informations sur les paramètres régionaux, notamment la langue favorite et le pays/région de l’utilisateur connecté.

Type : Microsoft.OutlookServices.LocaleInfo

PropriétéTypeDescription
DisplayNameChaîneNom représentant des paramètres régionaux par leur langage naturel, par exemple, « Anglais (États-Unis) ».
LocaleChaîneUne représentation de paramètres régionaux qui inclut la langue et le pays/la région. Par exemple, « en-us ». La composante linguistique suit les codes à deux lettres définis dans la norme ISO 639-1, et la composante pays suit les codes à deux lettres définis dans la norme ISO 3166-1 alpha-2.

Location (preview)

Localisation d’un événement.

Type : Microsoft.OutlookServices.Location

PropriétéTypeDescription
AddressPhysicalAddressAdresse physique de la localisation.
CoordonnéesGeoCoordinatesCoordonnées géographiques et élévation de la localisation.
DisplayNameChaîneNom associé au lieu.
LocationEmailAddressChaîneAdresse e-mail facultative de l’emplacement.
LocationUriChaîneURI facultatif représentant la localisation.
LocationTypeLocationTypeType de localisation : Default, ConferenceRoom, HomeAddress, BusinessAddress,GeoCoordinates, StreetAddress, Hotel, Restaurant, LocalBusiness, PostalAddress.

LocationConstraint

Conditions indiquées par un client pour le lieu d’une réunion.

Type : Microsoft.OutlookServices.LocationConstraint

PropriétéTypeDescription
IsRequiredbooléenLe client demande au service d’inclure dans la réponse d’un lieu de réunion pour la réunion.
SuggestLocationbooléenLe client demande au service de proposer un ou plusieurs lieux de réunion.
LocationsCollection(LocationConstraintItem)Un ou plusieurs lieux que le client demande pour une réunion.

LocationConstraintItem

Les conditions énoncées par un client pour vérifier la disponibilité de chaque lieu d’une réunion, et d’autres informations sur le lieu.

Type : Microsoft.OutlookServices.Location

PropriétéTypeDescription
ResolveAvailabilitybooléenSi la valeur est true et que la ressource spécifiée est occupée, FindMeetingTimes cherche une autre ressource disponible. Si la valeur est false et que la ressource spécifiée est occupée, FindMeetingTimes renvoie la ressource la mieux classée dans le cache de l’utilisateur sans vérifier si elle est disponible. La valeur par défaut est True.

MailTips (preview)

Messages informatifs affichés aux utilisateurs pendant qu'ils rédigent un message. Par exemple, un message d'absence du bureau en tant que réponse automatique pour un destinataire de message.

Type : Microsoft.OutlookServices.MailTips

PropriétéTypeDescription
EmailAddressEmailAddressAdresse e-mail du destinataire où envoyer des infos-courrier.
AutomaticRepliesAutomaticRepliesMailTipsAstuces par courrier pour la réponse automatique si elle a été configurée par le destinataire.
MailboxFullBooléenÉtat plein de la boîte aux lettres du destinataire.
CustomMailTipChaîneConseil personnalisé par courrier pouvant être défini dans la boîte aux lettres du destinataire.
ExternalMemberCountInt32Nombre de membres externes si le destinataire est une liste de distribution.
TotalMemberCountInt32Nombre de membres si le destinataire est une liste de distribution.
DeliveryRestrictedBooléenSi la boîte aux lettres du destinataire est restreinte, par exemple, accepter des messages provenant uniquement d'une liste prédéfinie d'expéditeurs, rejeter des messages d'une liste prédéfinie d'expéditeurs ou accepter des messages provenant uniquement d'expéditeurs authentifiés.
IsModeratedBooléenSi l'envoi de messages au destinataire nécessite une approbation. Par exemple, si le destinataire est une grande liste de distribution et qu’un modérateur a été configuré pour approuver les messages envoyés à cette liste de distribution ou si l’envoi de messages à un destinataire nécessite l’approbation du responsable du destinataire.
RecipientScopeRecipientScopeTypeL’étendue du destinataire, comme interne, externe, partenaire. Par exemple, un administrateur peut définir qu’une autre organisation soit son « partenaire ». L’étendue est utile si un administrateur souhaite que certains infos-courriers soient accessibles à certaines étendues. Il est également utile pour les expéditeurs de les informer que leur message pourrait quitter l’organisation, pour les aider à prendre les bonnes décisions concernant la formulation, le ton et le contenu.
RecipientSuggestionsCollection(Recipient)Destinataires suggérés en fonction des contextes précédents où ils apparaissent dans le même message.
MaxMessageSizeInt32Taille maximale des messages configurée pour l'organisation ou la boîte aux lettres du destinataire.
ErreurErreurLes erreurs qui se produisent pendant l’action GetMailTips.

MailboxSettings

Paramètres de la boîte aux lettres principale de l’utilisateur.

Type : Microsoft.OutlookServices.MailboxSettings

PropriétéTypeDescription
AutomaticRepliesSettingAutomaticRepliesSettingParamètres pour configurer l’envoi automatique des réponses aux messages entrants.
TimeZoneChaîneFuseau horaire par défaut pour la boîte aux lettres de l’utilisateur.
LangueLocaleInfoInformations de paramètres régionaux de l’utilisateur, y compris la langue par défaut et le pays/région préférés.
WorkingHoursWorkingHoursJours de la semaine et heures dans un fuseau horaire spécifique pendant lesquels l’utilisateur travaille.

MeetingTimeSuggestion

Suggestion de réunion qui inclut des informations telles que l’heure de la réunion, la probabilité de présence, la disponibilité individuelle du participant et les lieux de réunion disponibles.

Type : Microsoft.OutlookServices.MeetingTimeSuggestion

PropriétéTypeDescription
MeetingTimeSlotTimeSlotPériode suggérée pour la réunion.
ConfidencedoublePourcentage représentant la probabilité de présence de tous les participants.
OrganizerAvailabilityFreeBusyStatusDisponibilité de l’organisateur de la réunion pour cette suggestion de réunion : Free, Tentative, Busy, Oof, WorkingElsewhere, Unknown.
AttendeeAvailabilityCollection(AttendeeAvailability)Tableau qui indique le statut de disponibilité de chaque participant pour cette suggestion de réunion.
LocationsCollection(Location)Tableau qui indique le nom et l’emplacement géographique de chaque lieu de réunion pour cette suggestion de réunion.
SuggestionReasonChaîneDécrit les raisons pour suggérer l’heure de la réunion.

Niveau de probabilité d’une réunion

La propriété confidence d’un objet meetingTimeSuggestion est comprise entre 0 % et 100 %. Elle représente la probabilité de participation de tous les participants, en fonction de leurs disponibilités :

  • Pour chaque participant, le statut « disponible » pour le créneau horaire spécifié correspond à un niveau de probabilité de participation de 100 %, le statut « inconnu » à 49 % et le statut « occupé » à 0 %.
  • Pour calculer le niveau de probabilité d’une heure de réunion candidate, on calcule la moyenne du niveau de probabilité de participation indiqué par les participants pour cette réunion.
  • Vous pouvez utiliser le paramètre facultatif MinimumAttendeePercentage pour FindMeetingTimes afin de spécifier qu’uniquement des intervalles de temps de réunion d’au moins un certain niveau de probabilité doivent être retournés. Par exemple, vous pouvez spécifier un MinimumAttendeePercentage de 80 % si vous souhaitez uniquement des suggestions qui ont 80 % de chance ou plus que tous les participants assistent. Si vous ne spécifiez pas MinimumAttendeePercentage, FindMeetingTimes suppose une valeur de 50 %.
  • S« il y a plusieurs heures de réunions candidates, l’action FindMeetingTimes ordonne d’abord les heures candidates par leur valeur de niveau de probabilité calculée dans l’ordre décroissant. S'il y a des heures candidates qui ont le même niveau de probabilité, l’action les classe alors par ordre chronologique.

Par exemple, si un créneau de réunion implique 3 participants qui indiquent les informations de disponibilité suivantes :

AttendeeInformations de disponibilitéProbabilité de participation (%)
DanaGratuit100 %
NoëlInconnu49 %
FannyOccupé(e)0 %

Ainsi, le niveau de probabilité du créneau de réunion, qui correspond à la probabilité moyenne de participation, est (100 % + 49 % + 0 %)/3 = 49,66 %.

Si vous spécifiez un minimumAttendeePercentage de 80 % dans une opération findMeetingTimes, l’opération ne proposera pas ce créneau dans la réponse car 49,66 % < 80 %.

MeetingTimeSuggestionsResult

Collection de suggestions éventuelles de réunion, ou motif, le cas échéant.

Type : Microsoft.OutlookServices.MeetingTimeSuggestionsResult

PropriétéTypeDescription
MeetingTimeSuggestionsCollection(MeetingTimeSuggestion)Tableau de suggestions de réunion.
EmptySuggestionsReasonChaîneRaison pour ne pas retourner les suggestions de réunion. Les valeurs possibles sont : AttendeesUnavailable, LocationsUnavailable, OrganizerUnavailable, AttendeesUnavailableOrUnknown ou Unknown.

Raisons de ne retourner aucune suggestion de réunion

La propriétéEmptySuggestionsReason spécifie l'une des raisons suivantes pour lesquelles l’action FindMeetingTimes ne renvoie aucune suggestion de réunion. La propriété est une chaîne vide si FindMeetingTimes renvoie des suggestions de réunion.

ValueRaisons
AttendeesUnavailableLa disponibilité de tous les participants est connue, mais un nombre insuffisant de participants est disponible pour atteindre le seuil de fiabilité de la réunion, qui est de 50 % par défaut.
AttendeesUnavailableOrUnknownUne partie ou la totalité des participants ont une disponibilité inconnue, ce qui provoque la chute de la fiabilité de la réunion en dessous du seuil défini, qui est de 50 % par défaut. La disponibilité des participants peut devenir inconnue si le participant se trouve en dehors de l’organisation, ou si une erreur se produit lors de l’obtention des informations de disponibilité.
LocationsUnavailableLa propriété isRequired du paramètre locationConstraint est spécifié comme obligatoire mais il n’existe pas d’emplacements disponibles aux créneaux horaires calculés.
OrganizerUnavailableLe paramètre isOrganizerOptional est false mais l’organisateur n’est pas disponible pendant le créneau horaire demandé.
InconnuLe motif de l’absence de suggestions de réunion est inconnu.

MentionsPreview (preview)

Représente des informations sur les mentions dans une instance de ressource.

Type : Microsoft.OutlookServices.MentionsPreview

PropriétéTypeDescription
IsMentionedBooléenTrue si l'utilisateur connecté est mentionné dans l'instance de ressource parente. En lecture seule. Prend en charge les filtres.

MessageRuleActions (preview)

Représente l’ensemble d’actions qui sont disponibles pour une règle.

Type : Microsoft.OutlookServices.MessageRuleActions

PropriétéTypeDescription
AssignCategoriesCollection (String)Liste des catégories à affecter à un message.
CopyToFolderChaîneID du dossier dans lequel un message doit être copié.
SupprimerBooléenIndique si un message doit être déplacé vers le dossier Éléments supprimés.
ForwardAsAttachmentToCollection (Recipient)Adresses électroniques des destinataires auxquels un message doit être transféré en tant que pièce jointe.
ForwardToCollection (Recipient)Adresses électroniques des destinataires auxquels un message doit être transféré.
MarkAsReadBooléenIndique si un message doit être marqué comme lu.
MarkImportanceImportanceDéfinit l’importance du message, qui peut être : Low, Normal ou High.
MoveToFolderChaîneID du dossier vers lequel un message doit être déplacé.
PermanentDeleteBooléenIndique si un message doit être supprimé définitivement, sans être enregistré dans le dossier Éléments supprimés.
RedirectToDestinataireAdresse électronique vers laquelle un message doit être redirigé.
StopProcessingRulesBooléenIndique si les règles postérieures doivent être évaluées.

MessageRulePredicates (preview)

Représente l’ensemble de conditions et d’exceptions qui sont disponibles pour une règle.

Type : Microsoft.OutlookServices.MessageRulePredicates

PropriétéTypeDescription
BodyContainsCollection (String)Représente les chaînes qui doivent apparaître dans le corps d’un message entrant afin que la condition ou l’exception s’applique.
BodyOrSubjectContainsCollection (String)Représente les chaînes qui doivent apparaître dans le corps ou l’objet d’un message entrant afin que la condition ou l’exception s’applique.
CatégoriesCollection (String)Représente les catégories qui doivent apparaître dans le libellé d’un message entrant afin que la condition ou l’exception s’applique.
FromAddressesCollection (Recipient)Représente les adresses électroniques d’expéditeur spécifiques d’un message entrant afin que la condition ou l’exception s’applique.
HasAttachmentsBooléenIndique si un message entrant doit comporter des pièces jointes pour que la condition ou l’exception s’applique.
HeaderContainsCollection (String)Représente les chaînes qui s’affichent dans les en-têtes d’un message entrant afin que la condition ou l’exception s’applique.
ImportanceImportanceImportance indiquée concernant un message entrant afin que la condition ou l’exception s’applique : Low, Normal, High.
isApprovalRequestBooléenIndique si un message entrant doit être une demande d’approbation afin que la condition ou l’exception s’applique.
IsAutomaticForwardBooléenIndique si un message entrant doit être transmis automatiquement afin que la condition ou l’exception s’applique.
isAutomaticReplyBooléenIndique si un message entrant doit être une réponse automatique afin que la condition ou l’exception s’applique.
IsEncryptedBooléenIndique si un message entrant doit être chiffré afin que la condition ou l’exception s’applique.
IsMeetingRequestBooléenIndique si un message entrant doit être une demande de réunion afin que la condition ou l’exception s’applique.
IsMeetingResponseBooléenIndique si un message entrant doit être une réponse à une demande de réunion afin que la condition ou l’exception s’applique.
IsNonDeliveryReportBooléenIndique si un message entrant doit être une notification d’échec de remise afin que la condition ou l’exception s’applique.
IsPermissionControlledBooléenIndique si un message entrant doit être une autorisation contrôlée (protégée par RMS) afin que la condition ou l’exception s’applique.
IsReadReceiptBooléenIndique si un message entrant doit être une confirmation de lecture afin que la condition ou l’exception s’applique.
IsSignedBooléenIndique si un message entrant doit être un message signé S/MIME afin que la condition ou l’exception s’applique.
IsVoicemailBooléenIndique si un message entrant doit être un message vocal afin que la condition ou l’exception s’applique.
MessageActionFlagMessageActionFlagReprésente la valeur d’indicateur pour l’action qui s’affiche sur un message entrant afin que la condition ou l’exception s’applique.
NotSentToMeBooléenIndique si le propriétaire de la boîte aux lettres ne doit pas être un destinataire d’un message entrant afin que la condition ou l’exception s’applique.
RecipientContainsCollection (String)Représente les chaînes qui apparaissent dans la propriété toRecipients ou ccRecipients d’un message entrant afin que la condition ou l’exception s’applique.
SenderContainsCollection (String)Représente les chaînes qui s’affichent dans la propriété from d’un message entrant afin que la condition ou l’exception s’applique.
Critère de diffusionCritère de diffusionReprésente le niveau de confidentialité qui doit être marqué sur un message entrant afin que la condition ou l’exception s’applique. Les valeurs possibles sont les suivantes : Normal, Personal, Private et Confidential.
SentCcMeBooléenIndique si le propriétaire de la boîte aux lettres doit se trouver dans la propriété ccRecipients d’un message entrant afin que la condition ou l’exception s’applique.
SentOnlyToMeBooléenIndique si le propriétaire de la boîte aux lettres doit être le seul destinataire dans un message entrant afin que la condition ou l’exception s’applique.
SentToAddressesCollection (Recipient)Représente les adresses électroniques auxquelles un message entrant doit avoir été envoyé afin que la condition ou l’exception s’applique.
SentToMeBooléenIndique si le propriétaire de la boîte aux lettres doit être placé dans la propriété toRecipients d’un message entrant afin que la condition ou l’exception s’applique.
SentToOrCcMeBooléenIndique si le propriétaire de la boîte aux lettres doit se trouver dans la propriété toRecipients ou ccRecipients d’un message entrant afin que la condition ou l’exception s’applique.
SubjectContainsCollection (String)Représente les chaînes qui apparaissent dans l’objet d’un message entrant afin que la condition ou l’exception s’applique.
WithinSizeRangeSizeRangeReprésente les tailles minimale et maximale (en kilo-octets) entre lesquelles un message entrant doit être compris afin que la condition ou l’exception s’applique.

LocaleInfo

Informations sur les paramètres régionaux, notamment la langue favorite et le pays/région de l’utilisateur connecté.

Type : Microsoft.OutlookServices.LocaleInfo

PropriétéTypeDescription
DisplayNameChaîneNom représentant des paramètres régionaux par leur langage naturel, par exemple, « Anglais (États-Unis) ».
LocaleChaîneUne représentation de paramètres régionaux qui inclut la langue et le pays/la région. Par exemple, « en-us ». La composante linguistique suit les codes à deux lettres définis dans la norme ISO 639-1, et la composante pays suit les codes à deux lettres définis dans la norme ISO 3166-1 alpha-2.

Location

Localisation d’un événement.

Type : Microsoft.OutlookServices.Location

PropriétéTypeDescription
DisplayNameChaîneNom associé au lieu.
AddressPhysicalAddressAdresse physique de la localisation.
CoordonnéesGeoCoordinatesCoordonnées géographiques et élévation de la localisation.
LocationEmailAddressChaîneAdresse e-mail facultative de l’emplacement.

LocationConstraint

Conditions indiquées par un client pour le lieu d’une réunion.

Type : Microsoft.OutlookServices.LocationConstraint

PropriétéTypeDescription
IsRequiredbooléenLe client demande au service d’inclure dans la réponse d’un lieu de réunion pour la réunion.
SuggestLocationbooléenLe client demande au service de proposer un ou plusieurs lieux de réunion.
LocationsCollection(LocationConstraintItem)Un ou plusieurs lieux que le client demande pour une réunion.

LocationConstraintItem

Les conditions énoncées par un client pour vérifier la disponibilité de chaque lieu d’une réunion, et d’autres informations sur le lieu.

Type : Microsoft.OutlookServices.Location

PropriétéTypeDescription
ResolveAvailabilitybooléenSi la valeur est true et que la ressource spécifiée est occupée, FindMeetingTimes cherche une autre ressource disponible. Si la valeur est false et que la ressource spécifiée est occupée, FindMeetingTimes renvoie la ressource la mieux classée dans le cache de l’utilisateur sans vérifier si elle est disponible. La valeur par défaut est True.

MailboxSettings

Paramètres de la boîte aux lettres principale de l’utilisateur.

Type : Microsoft.OutlookServices.MailboxSettings

PropriétéTypeDescription
AutomaticRepliesSettingAutomaticRepliesSettingParamètres pour configurer l’envoi automatique des réponses aux messages entrants.
TimeZoneChaîneFuseau horaire par défaut pour la boîte aux lettres de l’utilisateur.
LangueLocaleInfoInformations de paramètres régionaux de l’utilisateur, y compris la langue par défaut et le pays/région préférés.

MeetingTimeSuggestion

Suggestion de réunion qui inclut des informations telles que l’heure de la réunion, la probabilité de présence, la disponibilité individuelle du participant et les lieux de réunion disponibles.

Type : Microsoft.OutlookServices.MeetingTimeSuggestion

PropriétéTypeDescription
MeetingTimeSlotTimeSlotPériode suggérée pour la réunion.
ConfidencedoublePourcentage représentant la probabilité de présence de tous les participants.
OrganizerAvailabilityFreeBusyStatusDisponibilité de l’organisateur de la réunion pour cette suggestion de réunion : Free, Tentative, Busy, Oof, WorkingElsewhere, Unknown.
AttendeeAvailabilityCollection(AttendeeAvailability)Tableau qui indique le statut de disponibilité de chaque participant pour cette suggestion de réunion.
LocationsCollection(Location)Tableau qui indique le nom et l’emplacement géographique de chaque lieu de réunion pour cette suggestion de réunion.
SuggestionReasonChaîneDécrit les raisons pour suggérer l’heure de la réunion.

Niveau de probabilité d’une réunion

La propriété confidence d’un objet meetingTimeSuggestion est comprise entre 0 % et 100 %. Elle représente la probabilité de participation de tous les participants, en fonction de leurs disponibilités :

  • Pour chaque participant, le statut « disponible » pour le créneau horaire spécifié correspond à un niveau de probabilité de participation de 100 %, le statut « inconnu » à 49 % et le statut « occupé » à 0 %.
  • Pour calculer le niveau de probabilité d’une heure de réunion candidate, on calcule la moyenne du niveau de probabilité de participation indiqué par les participants pour cette réunion.
  • Vous pouvez utiliser le paramètre facultatif MinimumAttendeePercentage pour FindMeetingTimes afin de spécifier qu’uniquement des intervalles de temps de réunion d’au moins un certain niveau de probabilité doivent être retournés. Par exemple, vous pouvez spécifier un MinimumAttendeePercentage de 80 % si vous souhaitez uniquement des suggestions qui ont 80 % de chance ou plus que tous les participants assistent. Si vous ne spécifiez pas MinimumAttendeePercentage, FindMeetingTimes suppose une valeur de 50 %.
  • S« il y a plusieurs heures de réunions candidates, l’action FindMeetingTimes ordonne d’abord les heures candidates par leur valeur de niveau de probabilité calculée dans l’ordre décroissant. S'il y a des heures candidates qui ont le même niveau de probabilité, l’action les classe alors par ordre chronologique.

Par exemple, si un créneau de réunion implique 3 participants qui indiquent les informations de disponibilité suivantes :

AttendeeInformations de disponibilitéProbabilité de participation (%)
DanaGratuit100 %
NoëlInconnu49 %
FannyOccupé(e)0 %

Ainsi, le niveau de probabilité du créneau de réunion, qui correspond à la probabilité moyenne de participation, est (100 % + 49 % + 0 %)/3 = 49,66 %.

Si vous spécifiez un minimumAttendeePercentage de 80 % dans une opération findMeetingTimes, l’opération ne proposera pas ce créneau dans la réponse car 49,66 % < 80 %.

MeetingTimeSuggestionsResult

Collection de suggestions éventuelles de réunion, ou motif, le cas échéant.

Type : Microsoft.OutlookServices.MeetingTimeSuggestionsResult

PropriétéTypeDescription
MeetingTimeSuggestionsCollection(MeetingTimeSuggestion)Tableau de suggestions de réunion.
EmptySuggestionsReasonChaîneRaison pour ne pas retourner les suggestions de réunion. Les valeurs possibles sont : AttendeesUnavailable, LocationsUnavailable, OrganizerUnavailable, AttendeesUnavailableOrUnknown ou Unknown.

Raisons de ne retourner aucune suggestion de réunion

La propriétéEmptySuggestionsReason spécifie l'une des raisons suivantes pour lesquelles l’action FindMeetingTimes ne renvoie aucune suggestion de réunion. La propriété est une chaîne vide si FindMeetingTimes renvoie des suggestions de réunion.

ValueRaisons
AttendeesUnavailableLa disponibilité de tous les participants est connue, mais un nombre insuffisant de participants est disponible pour atteindre le seuil de fiabilité de la réunion, qui est de 50 % par défaut.
AttendeesUnavailableOrUnknownUne partie ou la totalité des participants ont une disponibilité inconnue, ce qui provoque la chute de la fiabilité de la réunion en dessous du seuil défini, qui est de 50 % par défaut. La disponibilité des participants peut devenir inconnue si le participant se trouve en dehors de l’organisation, ou si une erreur se produit lors de l’obtention des informations de disponibilité.
LocationsUnavailableLa propriété isRequired du paramètre locationConstraint est spécifié comme obligatoire mais il n’existe pas d’emplacements disponibles aux créneaux horaires calculés.
OrganizerUnavailableLe paramètre isOrganizerOptional est false mais l’organisateur n’est pas disponible pendant le créneau horaire demandé.
InconnuLe motif de l’absence de suggestions de réunion est inconnu.

Location

Localisation d’un événement.

Type : Microsoft.OutlookServices.Location

PropriétéTypeDescription
DisplayNameChaîneNom associé au lieu.
AddressPhysicalAddressAdresse physique de la localisation.
CoordonnéesGeoCoordinatesCoordonnées géographiques et élévation de la localisation.

PatternedRecurrence

Modèle et plage de périodicité

Type : Microsoft.OutlookServices.PatternedRecurrence

PropriétéTypeDescription
MotifRecurrencePatternFréquence d’un événement.
RecurrenceTimeZoneChaîneLe fuseau horaire des heures de début et de fin. Voir le type complexe DateTimeTimeZone pour la liste des fuseaux horaires pris en charge.
RangeRecurrenceRangeDurée d’un événement.
PropriétéTypeDescription
MotifRecurrencePatternFréquence d’un événement.
RangeRecurrenceRangeDurée d’un événement.
PropriétéTypeDescription
MotifRecurrencePatternFréquence d’un événement.
RangeRecurrenceRangeDurée d’un événement.

Phone

Représente un numéro de téléphone.

Type : Microsoft.OutlookServices.Phone

PropriétéTypeDescription
NombrechaîneNuméro de téléphone.
TypeChaîneType de numéro de téléphone. Les valeurs possibles sont Home, Business, Mobile, Other, Assistant, HomeFax, BusinessFax, OtherFax, Pager, Radio.

PhysicalAddress

Adresse physique d’un contact.

Type : Microsoft.OutlookServices.PhysicalAddress

PropriétéTypeDescription
RueChaîneRue.
VilleChaîneVille.
ÉtatChaîneÉtat.
CountryOrRegionChaînePays ou région Il s’agit d’une valeur de chaîne de format libre, par exemple, « États-Unis ».
PostalCodeChaîneCode postal

Destinataire

Représente les informations sur un utilisateur à l’extrémité envoi ou réception d’un événement ou message.

Type : Microsoft.OutlookServices.Recipient

PropriétéTypeDescription
EmailAddressEmailAddressAdresse de messagerie du destinataire.

RecurrencePattern

Fréquence d’un événement.

Type : Microsoft.OutlookServices.RecurrencePattern

PropriétéTypeDescription
TypeRecurrencePatternTypeLe type de modèle de récurrence : Daily = 0, Weekly = 1, AbsoluteMonthly = 2, RelativeMonthly = 3, AbsoluteYearly = 4, RelativeYearly = 5.
Règles de modèle :
- AbsoluteYearly. Doit définir le Mois et le Jour du mois de l’occurrence
- RelativeYearly. Doit définir le Mois, Jours de la semaine, et l’indexer Premier jour de la semaine
- AbsoluteMonthly. Doit définir le Jour du mois
- RelativeMonthly. Doit définir l'indexer Premier jour de la semaine et le RecurrenceRange.NumberOfOccurrences
- Weekly. Doit définir les Jours de la semaine et le Premier jour de la semaine
- Daily. Aucune information de modèle supplémentaire nécessaire.
IntervalleInt32Nombre d’unités d’un type de périodicité donné entre plusieurs occurrences.
DayOfMonthInt32Le jour du mois où l’élément se produit.
MoisInt32Le mois où l’élément se produit. Il s’agit d’un nombre compris entre 1 et 12.
DaysOfWeekCollection (DayOfWeek)Une collection de jours de la semaine : Dimanche = 0, Lundi = 1, Mardi = 2, Mercredi = 3, Jeudi = 4, Vendredi = 5, Samedi = 6.
FirstDayOfWeekDayOfWeekLe jour de la semaine : Dimanche = 0, Lundi = 1, Mardi = 2, Mercredi = 3, Jeudi = 4, Vendredi = 5, Samedi = 6.
IndexWeekIndexL’indexer de semaine : Premier = 0, Deuxième = 1, Troisième = 2, Quatrième = 3, Dernier = 4.

RecurrenceRange

Durée d’un événement.

Type : Microsoft.OutlookServices.RecurrenceRange

PropriétéTypeDescription
TypeRecurrenceRangeTypeLa plage de récurrence : EndDate = 0, NoEnd = 1, Numbered = 2.
StartDatedatetimeoffsetObligatoire : date de début de la série.
EndDatedatetimeoffsetObligatoire pour les modèles liés à la date : la date de fin de la série. Doit être ultérieure à la date de début.
NumberOfOccurrencesInt32Obligatoire pour les motifs numérotés : combien de fois faut-il répéter l'événement.

ResponseStatus

État de la réponse d’une demande de réunion.

Type : Microsoft.OutlookServices.ResponseStatus

PropriétéTypeDescription
RéponseResponseTypeLe type de réponse : None, Organizer, TentativelyAccepted, Accepted, Declined, NotResponded.
TimedatetimeoffsetDate et heure auxquelles la réponse a été renvoyée.

SizeRange (preview)

Spécifie les tailles maximale et minimale (en kilo-octets) que doit avoir un message entrant afin qu’une condition ou une exception s’applique.

Type : Microsoft.OutlookServices.SizeRange

PropriétéTypeDescription
MaximumSizeInt32Taille maximale (en kilo-octets) que doit avoir un message entrant afin qu’une condition ou une exception s’applique.
MinimumSizeInt32Taille minimale (en kilo-octets) que doit avoir un message entrant afin qu’une condition ou une exception s’applique.

TimeConstraint

Restreint les suggestions de réunion à certains jours et heures de la semaine selon la nature de l’activité spécifiée et les créneaux horaires libres.

Type :Microsoft.OutlookServices.TimeConstraint

PropriétéTypeDescription
ActivityDomainActivityDomainFacultatif, la nature de l’activité : Work, Personal, Unrestricted, ou Unknown.
TimeslotsCollection(TimeSlot)Tableau de périodes de temps.

TimeSlot

Période.

Type : Microsoft.OutlookServices.TimeSlot

PropriétéTypeDescription
DébutDateTimeTimeZoneHeure de début d’une période.
EndDateTimeTimeZoneHeure de fin d’une période.

TimeZoneInformation (preview)

Représente un fuseau horaire. Les formats de fuseau horaire pris en charge sont Windows et IANA (Internet Assigned Numbers Authority), également appelé fuseau horaire Olson.

Type : Microsoft.OutlookServices.TimeZoneInformation

PropriétéTypeDescription
AliasChaîneIdentificateur du fuseau horaire.
DisplayNameChaîneChaîne d’affichage représentant le fuseau horaire.

Website (preview)

Représente un site web.

Type : Microsoft.OutlookServices.Website

PropriétéTypeDescription
AddressChaîneURL du site Web.
DisplayNameChaîneNom complet du site web.
TypeWebsiteTypeType de site Web couramment associé à un contact. Les valeurs possibles sont les suivantes : Blog, Home, Other, Profile et Work.

WorkingHours (preview)

Représente les jours de la semaine et les heures dans un fuseau horaire spécifique pendant lesquelles l’utilisateur travaille.

Type : Microsoft.OutlookServices.WorkingHours

PropriétéTypeDescription
DaysOfWeekCollection(DayOfWeek)Collection de jours de la semaine pendant lesquels l’utilisateur travaille : Dimanche = 0, Lundi = 1, Mardi = 2, Mercredi = 3, Jeudi = 4, Vendredi = 5, Samedi = 6.
StartTimeEdm.TimeOfDayHeure du jour où l’utilisateur comment à travailler.
EndTimeEdm.TimeOfDayHeure du jour où l’utilisateur arrête de travailler.
TimeZoneChaîneFuseau horaire auquel s’appliquent les heures de travail. Voir DateTimeTimeZone pour une liste de fuseaux horaires valides.

TimeConstraint

Restreint les suggestions de réunion à certains jours et heures de la semaine selon la nature de l’activité spécifiée et les créneaux horaires libres.

Type :Microsoft.OutlookServices.TimeConstraint

PropriétéTypeDescription
ActivityDomainActivityDomainFacultatif, la nature de l’activité : Work, Personal, Unrestricted, ou Unknown.
TimeslotsCollection(TimeSlot)Tableau de périodes de temps.

TimeSlot

Période.

Type : Microsoft.OutlookServices.TimeSlot

PropriétéTypeDescription
DébutDateTimeTimeZoneHeure de début d’une période.
EndDateTimeTimeZoneHeure de fin d’une période.

Énumérations

ActivityDomain | AutomaticRepliesStatus | CategoryColor (preview) | DayOfWeek | ExternalAudienceScope |
FollowupFlagStatus (preview) | FreeBusyStatus | InferenceClassificationType | LocationType (preview) | MailTipsType (preview) | MessageActionFlag (preview) | PhoneType (preview) | RecipientScopeType (preview) | ReferenceAttachmentPermissions | ReferenceAttachmentProviders | TaskStatus | TimeZoneStandard | WebsiteType

ActivityDomain | AutomaticRepliesStatus | DayOfWeek | ExternalAudienceScope |
FreeBusyStatus | InferenceClassificationType | TaskStatus

ActivityDomain

La nature d’une activité

Valeurs prises en charge :

  • Travail
  • Personnel
  • Illimité
  • Inconnu

AutomaticRepliesStatus

L’état de la configuration pour l’envoi automatique d’une réponse lorsque la boîte aux lettres de l’utilisateur reçoit un message.

Valeurs prises en charge :

  • AlwaysEnabled
  • Désactivé
  • Programmé

DayOfWeek

Ensemble des jours de la semaine.

Valeurs prises en charge :

  • Dimanche
  • Lundi
  • Mardi
  • Mercredi
  • Jeudi
  • Vendredi
  • Samedi

ExternalAudienceScope

Ensemble de l’auditoire externe où envoyer le ExternalReplyMessage.

Valeurs prises en charge :

  • Tous
  • ContactsOnly
  • None

FreeBusyStatus

Spécifie l’état de disponibilité d’un participant pour une réunion.

Valeurs prises en charge :

  • Occupé(e)
  • Gratuite
  • Absence du bureau
  • Provisoire
  • Inconnu
  • WorkingElsewhere

InferenceClassificationType

Représente la pertinence inférée d’un message sur lequel un utilisateur doit se concentrer.

Valeurs prises en charge :

  • Éléments ciblés
  • Autre

ActivityDomain

La nature d’une activité

Valeurs prises en charge :

  • Travail
  • Personnel
  • Illimité
  • Inconnu

AutomaticRepliesStatus

L’état de la configuration pour l’envoi automatique d’une réponse lorsque la boîte aux lettres de l’utilisateur reçoit un message.

Valeurs prises en charge :

  • AlwaysEnabled
  • Désactivé
  • Programmé

CategoryColor (preview)

Couleur qui caractérise une catégorie dans la boîte aux lettres de l’utilisateur. La couleur réelle que représente chaque constante prédéfinie dépend du client Outlook utilisé pour afficher les catégories.

Valeur prise en chargeCouleur mappée dans le client de bureau Outlook
Preset0Rouge
Preset1Orange
Preset2Marron
Preset3Jaune
Preset4Vert
Preset5Bleu-vert
Preset6Olive
Preset7Bleu
Preset8Violet
Preset9Couleur canneberge
Preset10Gris acier
Preset11Acier foncé
Preset12Gris
Preset13Gris foncé
Preset14Noir
Preset15Rouge foncé
Preset16Orange foncé
Preset17Marron foncé
Preset18Jaune foncé
Preset19Vert foncé
Preset20Bleu-vert foncé
Preset21Olive foncé
Preset22Bleu foncé
Preset23Violet foncé
Preset24Couleur canneberge foncé
NoneAucune couleur mappée

ExternalAudienceScope

Ensemble de l’auditoire externe où envoyer le ExternalReplyMessage.

Valeurs prises en charge :

  • Tous
  • ContactsOnly
  • None

FollowupFlagStatus (preview)

Représente l’état de l’indicateur de suivi pour une instance de ressource.

Valeurs prises en charge :

  • Terminé
  • Marqué d’un indicateur
  • Non marqué d’un indicateur

InferenceClassificationType

Représente la pertinence inférée d’un message sur lequel un utilisateur doit se concentrer.

Valeurs prises en charge :

  • Éléments ciblés
  • Autre

LocationType (preview)

Types d’emplacements possibles.

Valeurs prises en charge :

  • Par défaut
  • ConferenceRoom
  • HomeAddress
  • BusinessAddress
  • GeoCoordinates
  • StreetAddress
  • Hôtel
  • Restaurant
  • LocalBusiness
  • PostalAddress

MailTipsType (preview)

Énumération des drapeaux représentant les infos-courriers demandés.

Valeurs prises en charge :

  • AutomaticReplies
  • CustomMailTip
  • DeliveryRestriction
  • ExternalMemberCount
  • MailboxFullStatus
  • MaxMessageSize
  • ModerationStatus
  • RecipientScope
  • RecipientSuggestions
  • TotalMemberCount

MessageActionFlag (preview)

Spécifie l’action à effectuer pour un message.

Valeurs prises en charge :

  • Tout
  • Appel
  • DoNotForward
  • FollowUp
  • Pour info
  • Transférer
  • NoResponseNecessary
  • Lire
  • Répondre
  • ReplyToAll
  • Passer en revue

PhoneType (preview)

Le type de numéros de téléphone généralement associés à un contact.

Valeurs prises en charge :

  • Assistant
  • Entreprise
  • BusinessFax
  • Domicile
  • HomeFax
  • Mobile
  • Autre
  • OtherFax
  • Radiomessagerie
  • Radio

RecipientScopeType (preview)

Énumération des indicateurs qui représente les types d’étendues de destinataires. Les étendues de destinataire sont utilisées par les administrateurs pour spécifier que certaines infos-courrier soient accessibles uniquement à une certaine étendue.

Valeurs prises en charge :

  • None
  • Interne
  • Externe
  • ExternalPartner
  • ExternalNonPartner

ReferenceAttachmentPermissions

Accéder aux autorisations pour le fichier ou le dossier de la pièce jointe de référence.

Valeurs prises en charge :

  • Autre
  • Vue
  • Modifier
  • AnonymousView
  • AnonymousEdit
  • OrganizationView
  • OrganizationEdit

ReferenceAttachmentProviders

Fournisseurs de stockage de fichiers possibles pour les pièces jointes de référence.

Valeurs prises en charge :

  • Dropbox
  • OneDriveBusiness
  • OneDriveConsumer
  • Autre

Critère de diffusion

Indique le niveau de confidentialité.

Valeurs prises en charge :

  • Normal
  • Personnel
  • Privé
  • Confidentiel

TaskStatus

Spécifie l’état ou la progression d’une tâche.

Valeurs prises en charge :

  • Achevé
  • Deferred
  • InProgress
  • NotStarted
  • WaitingOnOthers

TimeZoneStandard (preview)

Format pour exprimer les fuseaux horaires.

Valeurs prises en charge :

  • Windows
  • Iana

WebsiteType (preview)

Spécifier le type de site Web couramment associé à un contact.

Valeurs prises en charge :

  • Blog
  • Domicile
  • Autre
  • Profil
  • Travail

TaskStatus

Spécifie l’état ou la progression d’une tâche.

Valeurs prises en charge :

  • Achevé
  • Deferred
  • InProgress
  • NotStarted
  • WaitingOnOthers

Utiliser les paramètres de requête OData

Vous pouvez utiliser les paramètres de requête de la norme OData v4.0 pour filtrer les demandes de données ainsi que pour trier et afficher les résultats lorsque vous travaillez avec les API Mail, Calendrier et Contacts. Lorsque vous spécifiez des paramètres de requête, assurez-vous que les caractères qui sont réservés aux significations spéciales dans un URI sont codés de manière appropriée.

  • $search pour rechercher des critères spécifiques

  • $filter pour filtrer des critères spécifiques

  • $select pour demander des propriétés spécifiques

  • $orderby pour trier les résultats

  • $top et $skip pour afficher les résultats par page

  • $expand pout développer les pièces jointes de messages et les pièces jointes d’événements

  • $count pour obtenir le nombre d’entités dans une collection. Ce paramètre va dans le chemin de l’URL : .../me/calendars/$count

Les requêtes avec les API Courrier, Calendrier et Contacts utilisent toujours une étendue peu profonde. Seuls les éléments du dossier actuel sont renvoyés. Les recherches approfondies ne sont pas prises en charge.

Demandes de consultation

Vous pouvez utiliser le paramètre $search pour limiter les résultats d'une requête aux messages qui correspondent à une expression de recherche. Les chaînes de recherche sont exprimées à l’aide d’AQS (syntaxe de requête avancée). Les résultats sont triés par date et heure d’envoi du message.

Remarque Vous pouvez obtenir jusqu'à 250 résultats à partir d’une demande $search. Vous pouvez utiliser $search uniquement avec des messages. La recherche de contacts et d’événements de calendrier n’est pas prise en charge.

Vous ne pouvez pas utiliser $filter ou $orderby dans une requête de recherche. Si vous le faites, vous recevrez un message d’erreur comme celui-ci.

{
  "error":
  {
    "code":"ErrorInvalidUrlQuery",
    "message":"The query parameter 'OrderBy' is invalid."
  }
}
PropriétéDescription
Pièce jointeRecherche la pièce jointe spécifiée par titre.
CciRecherche le champ CcI.
Corps ou contenuRecherche le champ Corps. Uniquement pris en charge avec les recherches par défaut.
CategoryRecherche le champ Catégorie.
CcRecherche le champ Cc.
FromRecherche le champ De.
HasRecherche le champ PiècesJointes.
ParticipantsRecherche les champs À, Cc, et CcI.
ReceivedRecherche le champ Reçu pour une date spécifique exprimée en MM/JJ/AAAA.
SenderRecherche le champ Expéditeur.
SubjectRecherche le champ Objet.
ToRecherche le champ À.

Vous recherchez des champs communs en utilisant le paramètre de requête $search sans spécifier de propriété. Une recherche par défaut va rechercher les propriétés Body, Sender, et Object. La recherche suivante retournera tous les messages dans la boîte de réception contenant « pizza » dans l’une des trois propriétés par défaut.

Passons en revue quelques exemples. Pour les rendre plus lisibles, les URL des exemples n'ont pas été codées dans un format d’URL ; toutefois, si vous essayez ces exemples, assurez-vous de les coder sous forme d’URL avant de les envoyer au serveur.

Pour obtenir tous les messages dans la boîte de réception qui contiennent le mot « Pizza » dans la propriété From, Subject, ou Body, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/beta/me/messages?$search="pizza"

Pour obtenir tous les messages dans la boîte de réception qui contiennent le mot « Pizza » dans la propriété Object, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/beta/me/messages?$search="subject:pizza"

Pour obtenir tous les messages dans la boîte de réception qui ont été envoyés par une personne spécifique, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/beta/me/messages?$search="from:help@contoso.com"

Les exemples ci-dessus n'incluent pas l’encodage d'URL, voici les mêmes exemples encodés sous forme d’URL et prêts à être envoyés à votre serveur :

GET https://outlook.office.com/api/beta/me/messages?$search=%22pizza%22
GET https://outlook.office.com/api/beta/me/messages?$search=%22subject:pizza%22
GET https://outlook.office.com/api/beta/me/messages?$search=%22from:help@contoso.com%22

Pour obtenir tous les messages dans la boîte de réception qui contiennent le mot « Pizza » dans la propriété From, Subject, ou Body, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/v2.0/me/messages?$search="pizza"

Pour obtenir tous les messages dans la boîte de réception qui contiennent le mot « Pizza » dans la propriété Object, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/v2.0/me/messages?$search="subject:pizza"

Pour obtenir tous les messages dans la boîte de réception qui ont été envoyés par une personne spécifique, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/v2.0/me/messages?$search="from:help@contoso.com"

Les exemples ci-dessus n'incluent pas l’encodage d'URL, voici les mêmes exemples encodés sous forme d’URL et prêts à être envoyés à votre serveur :

GET https://outlook.office.com/api/v2.0/me/messages?$search=%22pizza%22
GET https://outlook.office.com/api/v2.0/me/messages?$search=%22subject:pizza%22
GET https://outlook.office.com/api/v2.0/me/messages?$search=%22from:help@contoso.com%22

Pour obtenir tous les messages dans la boîte de réception qui contiennent le mot « Pizza » dans la propriété From, Subject, ou Body, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/v1.0/me/messages?$search="pizza"

Pour obtenir tous les messages dans la boîte de réception qui contiennent le mot « Pizza » dans la propriété Object, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/v1.0/me/messages?$search="subject:pizza"

Pour obtenir tous les messages dans la boîte de réception qui ont été envoyés par une personne spécifique, vous pouvez utiliser cette demande.

GET https://outlook.office.com/api/v1.0/me/messages?$search="from:help@contoso.com"

Les exemples ci-dessus n'incluent pas l’encodage d'URL, voici les mêmes exemples encodés sous forme d’URL et prêts à être envoyés à votre serveur :

GET https://outlook.office.com/api/v1.0/me/messages?$search=%22pizza%22
GET https://outlook.office.com/api/v1.0/me/messages?$search=%22subject:pizza%22
GET https://outlook.office.com/api/v1.0/me/messages?$search=%22from:help@contoso.com%22

Filtrer les demandes

Vous pouvez utiliser le paramètre de requête $filter pour spécifier des critères de recherche en utilisant les opérateurs de filtre suivants.

Toutes les propriétés ne prennent pas en charge le filtrage. Seules les propriétés de la ressource ont marqué « Oui » dans la colonne « Filtrable ? » dans leurs tableaux correspondants ci-dessus peuvent être utilisés. Si une propriété n'est pas filtrable, vous recevrez un message d’erreur en réponse, comme celui-ci qui est retourné si vous essayez de filtrer sur la propriété ChangeKey :

{
  "error":
  {
    "code":"ErrorInvalidProperty",
    "message":"The property 'ChangeKey' does not support filtering."
  }
}

Si vous utilisez une méthode de filtrage non prise en charge, vous obtiendrez un message d’erreur comme celui-ci qui est retourné lorsque la startswith méthode de filtrage est utilisée sur la propriété Subject :

{
  "error":
  {
    "code":"ErrorInvalidUrlQueryFilter",
    "message":"'contains' and 'startswith' are not supported for filtering.  Use Search instead."
  }
}
OpérateurTypeExemple
etEt logique (utilisé pour combiner plusieurs critères)TotalCount gt 0 and ChildFolderCount eq 0
ouOu logique (utilisé pour combiner plusieurs critères)TotalCount gt 0 or ChildFolderCount eq 0
eqÉgal àIsRead eq false
neN’est pas égal àImportance ne Microsoft.Exchange.Services.OData.Model.Importance'High'
gtSupérieur àReceivedDateTime gt 2014-09-01T00:00:00Z
geSupérieur ou égal àLastModifiedDateTime ge 2014-09-01T00:00:00Z
ltInférieur àReceivedDateTime lt 2014-09-01T00:00:00Z
leInférieur ou égal àLastModifiedDateTime le 2014-09-01T00:00:00Z

Utilisez des guillemets simples (') pour délimiter toute valeur de chaîne dans le critère de filtre. Utiliser %27 pour coder le guillemet simple dans un format d’URL. La chaîne elle-même n’est pas sensible à la casse.

Passons en revue quelques exemples. Pour les rendre plus lisibles, les URL des exemples n'ont pas été codées dans un format d’URL ; toutefois, si vous essayez ces exemples, assurez-vous de les coder sous forme d’URL avant de les envoyer au serveur.

Pour obtenir tous les événements du calendrier par défaut de l’utilisateur qui commencent à ou après une date spécifique, vous pouvez filtrer sur la propriété Start.

GET https://outlook.office.com/api/beta/me/events?$filter=Start/DateTime ge '2016-04-01T08:00'

Pour obtenir tous les événements dans le calendrier de l’utilisateur avec un objet spécifique, vous pouvez filtrer sur la propriété Subject.

GET https://outlook.office.com/api/beta/me/events?$filter=Subject eq 'Mega Charity Bash'

Pour obtenir tous les messages non lus dans la boîte de réception, vous pouvez filtrer sur la propriété IsRead.

GET https://outlook.office.com/api/beta/me/messages?$filter=IsRead eq false

Pour obtenir tous les messages dans la boîte de réception avec pièces jointes, vous pouvez filtrer sur la propriété HasAttachments.

GET https://outlook.office.com/api/beta/me/messages?$filter=HasAttachments eq true

Pour recevoir tous les messages reçus dans la boîte de réception depuis le 1er septembre 2014, vous pouvez filtrer sur la propriété ReceivedDateTime.

GET https://outlook.office.com/api/beta/me/messages?$filter=ReceivedDateTime ge 2014-09-01

Pour obtenir tous les messages dans la boîte de réception envoyés à partir de l’adresse « hr@contoso.com », vous pouvez filtrer sur la propriété Sender.

GET https://outlook.office.com/api/beta/me/messages?$filter=From/EmailAddress/Address eq 'hr@contoso.com'

Les exemples ci-dessus n'incluent pas l’encodage d'URL, voici les mêmes exemples encodés sous forme d’URL et prêts à être envoyés à votre serveur :

GET https://outlook.office.com/api/beta/me/events?$filter=Start/DateTime%20ge%20%272016-04-01T08:00%27
GET https://outlook.office.com/api/beta/me/events?$filter=Subject%20eq%20%27Mega%20Charity%20Bash%27
GET https://outlook.office.com/api/beta/me/messages?$filter=IsRead%20eq%20false
GET https://outlook.office.com/api/beta/me/messages?$filter=HasAttachments%20eq%20true
GET https://outlook.office.com/api/beta/me/messages?$filter=ReceivedDateTime%20ge%202014-09-01
GET https://outlook.office.com/api/beta/me/messages?$filter=From/EmailAddress/Address%20eq%20%27hr@contoso.com%27
OpérateurTypeExemple
etEt logique (utilisé pour combiner plusieurs critères)TotalCount gt 0 and ChildFolderCount eq 0
ouOu logique (utilisé pour combiner plusieurs critères)TotalCount gt 0 or ChildFolderCount eq 0
eqÉgal àIsRead eq false
neN’est pas égal àImportance ne Microsoft.Exchange.Services.OData.Model.Importance'High'
gtSupérieur àReceivedDateTime gt 2014-09-01T00:00:00Z
geSupérieur ou égal àLastModifiedDateTime ge 2014-09-01T00:00:00Z
ltInférieur àReceivedDateTime lt 2014-09-01T00:00:00Z
leInférieur ou égal àLastModifiedDateTime le 2014-09-01T00:00:00Z

Utilisez des guillemets simples (') pour délimiter toute valeur de chaîne dans le critère de filtre. Utiliser %27 pour coder le guillemet simple dans un format d’URL. La chaîne elle-même n’est pas sensible à la casse.

Passons en revue quelques exemples. Pour les rendre plus lisibles, les URL des exemples n'ont pas été codées dans un format d’URL ; toutefois, si vous essayez ces exemples, assurez-vous de les coder sous forme d’URL avant de les envoyer au serveur.

Pour obtenir tous les événements du calendrier par défaut de l’utilisateur qui commencent à ou après une date spécifique, vous pouvez filtrer sur la propriété Start.

GET https://outlook.office.com/api/v2.0/me/events?$filter=Start/DateTime ge '2016-04-01T08:00'

Pour obtenir tous les événements dans le calendrier de l’utilisateur avec un objet spécifique, vous pouvez filtrer sur la propriété Subject.

GET https://outlook.office.com/api/v2.0/me/events?$filter=Subject eq 'Mega Charity Bash'

Pour obtenir tous les messages non lus dans la boîte de réception, vous pouvez filtrer sur la propriété IsRead.

GET https://outlook.office.com/api/v2.0/me/messages?$filter=IsRead eq false

Pour obtenir tous les messages dans la boîte de réception avec pièces jointes, vous pouvez filtrer sur la propriété HasAttachments.

GET https://outlook.office.com/api/v2.0/me/messages?$filter=HasAttachments eq true

Pour recevoir tous les messages reçus dans la boîte de réception depuis le 1er septembre 2014, vous pouvez filtrer sur la propriété ReceivedDateTime.

GET https://outlook.office.com/api/v2.0/me/messages?$filter=ReceivedDateTime ge 2014-09-01

Pour obtenir tous les messages dans la boîte de réception envoyés à partir de l’adresse « hr@contoso.com », vous pouvez filtrer sur la propriété Sender.

GET https://outlook.office.com/api/v2.0/me/messages?$filter=From/EmailAddress/Address eq 'hr@contoso.com'

Les exemples ci-dessus n'incluent pas l’encodage d'URL, voici les mêmes exemples encodés sous forme d’URL et prêts à être envoyés à votre serveur :

GET https://outlook.office.com/api/v2.0/me/events?$filter=Start/DateTime%20ge%20%272016-04-01T08:00%27
GET https://outlook.office.com/api/v2.0/me/events?$filter=Subject%20eq%20%27Mega%20Charity%20Bash%27
GET https://outlook.office.com/api/v2.0/me/messages?$filter=IsRead%20eq%20false
GET https://outlook.office.com/api/v2.0/me/messages?$filter=HasAttachments%20eq%20true
GET https://outlook.office.com/api/v2.0/me/messages?$filter=ReceivedDateTime%20ge%202014-09-01
GET https://outlook.office.com/api/v2.0/me/messages?$filter=From/EmailAddress/Address%20eq%20%27hr@contoso.com%27
OpérateurTypeExemple
etEt logique (utilisé pour combiner plusieurs critères)TotalCount gt 0 and ChildFolderCount eq 0
ouOu logique (utilisé pour combiner plusieurs critères)TotalCount gt 0 or ChildFolderCount eq 0
eqÉgal àIsRead eq false
neN’est pas égal àImportance ne Microsoft.Exchange.Services.OData.Model.Importance'High'
gtSupérieur àDateTimeReceived gt 2014-09-01T00:00:00Z
geSupérieur ou égal àDateTimeLastModified ge 2014-09-01T00:00:00Z
ltInférieur àDateTimeReceived lt 2014-09-01T00:00:00Z
leInférieur ou égal àDateTimeLastModified le 2014-09-01T00:00:00Z

Utilisez des guillemets simples (') pour délimiter toute valeur de chaîne dans le critère de filtre. Utiliser %27 pour coder le guillemet simple dans un format d’URL. La chaîne elle-même n’est pas sensible à la casse.

Passons en revue quelques exemples. Pour les rendre plus lisibles, les URL des exemples n'ont pas été codées dans un format d’URL ; toutefois, si vous essayez ces exemples, assurez-vous de les coder sous forme d’URL avant de les envoyer au serveur.

Pour obtenir tous les événements dans le calendrier de l’utilisateur avec un objet spécifique, vous pouvez filtrer sur la propriété Subject.

GET https://outlook.office.com/api/v1.0/me/events?$filter=Subject eq 'Mega Charity Bash'

Pour obtenir tous les messages non lus dans la boîte de réception, vous pouvez filtrer sur la propriété IsRead.

GET https://outlook.office.com/api/v1.0/me/messages?$filter=IsRead eq false

Pour obtenir tous les messages dans la boîte de réception avec pièces jointes, vous pouvez filtrer sur la propriété HasAttachments.

GET https://outlook.office.com/api/v1.0/me/messages?$filter=HasAttachments eq true

Pour recevoir tous les messages reçus dans la boîte de réception depuis le 1er septembre 2014, vous pouvez filtrer sur la propriété DateTimeReceived.

GET https://outlook.office.com/api/v1.0/me/messages?$filter=DateTimeReceived ge 2014-09-01

Pour obtenir tous les messages dans la boîte de réception envoyés à partir de l’adresse « hr@contoso.com », vous pouvez filtrer sur la propriété Sender.

GET https://outlook.office.com/api/v1.0/me/messages?$filter=From/EmailAddress/Address eq 'hr@contoso.com'

Les exemples ci-dessus n'incluent pas l’encodage d'URL, voici les mêmes exemples encodés sous forme d’URL et prêts à être envoyés à votre serveur :

GET https://outlook.office.com/api/v1.0/me/events?$filter=Subject%20eq%20%27Mega%20Charity%20Bash%27
GET https://outlook.office.com/api/v1.0/me/messages?$filter=IsRead%20eq%20false
GET https://outlook.office.com/api/v1.0/me/messages?$filter=HasAttachments%20eq%20true
GET https://outlook.office.com/api/v1.0/me/messages?$filter=DateTimeReceived%20ge%202014-09-01
GET https://outlook.office.com/api/v1.0/me/messages?$filter=From/EmailAddress/Address%20eq%20%27hr@contoso.com%27

Sélectionnez les propriétés spécifiques à renvoyer

Vous pouvez utiliser le paramètre de requête $select pour spécifier uniquement les propriétés dont votre application a besoin.

Remarque Lorsque vous recevez des éléments de courrier, de calendrier et de contact, utilisez toujours $select pour exclure les propriétés inutiles dans la charge utile de réponse afin de maintenir une performance raisonnable de l’application. Si vous n’incluez pas un paramètre $select, toutes les propriétés des éléments sont renvoyées.

L’exemple suivant obtient les propriétés Subject, Sender, et ReceivedDateTime pour tous les messages dans la boîte de réception.

GET https://outlook.office.com/api/beta/me/messages?$select=Subject,Sender,ReceivedDateTime

L’exemple suivant obtient les propriétés Subject, Sender, et ReceivedDateTime pour tous les messages dans la boîte de réception.

GET https://outlook.office.com/api/v2.0/me/messages?$select=Subject,Sender,ReceivedDateTime

L’exemple suivant obtient les propriétés Subject, Sender, et DateTimeReceived pour tous les messages dans la boîte de réception.

GET https://outlook.office.com/api/v1.0/me/messages?$select=Subject,Sender,DateTimeReceived

Trier les résultats

Vous pouvez trier les résultats en utilisant le paramètre de requête $orderby. Définissez la valeur de ce paramètre sur un nom de propriété et spécifiez facultativement l’ordre croissant (par défaut) ou décroissant. Rappelez-vous, vous ne pouvez pas utiliser le paramètre de requête $orderby avec $search.

L’exemple suivant sans codage d'URL récupère tous les messages de la boîte de réception triés par la propriété ReceivedDateTime dans l’ordre décroissant.

GET https://outlook.office.com/api/beta/me/messages?$orderby=ReceivedDateTime desc

Le même exemple avec l’encodage d’URL :

GET https://outlook.office.com/api/beta/me/messages?$orderby=ReceivedDateTime%20desc

L’exemple suivant sans codage d'URL récupère tous les messages de la boîte de réception triés par la propriété ReceivedDateTime dans l’ordre décroissant.

GET https://outlook.office.com/api/v2.0/me/messages?$orderby=ReceivedDateTime desc

Le même exemple avec l’encodage d’URL :

GET https://outlook.office.com/api/v2.0/me/messages?$orderby=ReceivedDateTime%20desc

L’exemple suivant sans codage d'URL récupère tous les messages de la boîte de réception triés par la propriété DateTimeReceived dans l’ordre décroissant.

GET https://outlook.office.com/api/v1.0/me/messages?$orderby=DateTimeReceived desc

Le même exemple avec l’encodage d’URL :

GET https://outlook.office.com/api/v1.0/me/messages?$orderby=DateTimeReceived%20desc

Page de résultats

Par défaut, une requête GET sur une propriété Messages ou ChildFolders, une collection ou un CalendrierView renvoie dix entrées (maximum 50). Vous pouvez changer ce comportement en utilisant le paramètre de requête $top pour définir un nombre maximal. L’exemple suivant récupère les cinq premiers messages dans la boîte de réception.

GET https://outlook.office.com/api/beta/me/messages?$top=5

S’il y a plus de cinq messages dans la boîte de réception, la réponse inclut la propriété odata.nextLink. La présence de cette propriété indique qu’il y a plus d’éléments disponibles sur le serveur. La valeur de cette propriété est un URI qui peut être utilisé pour obtenir les cinq éléments suivants.

GET https://outlook.office.com/api/beta/me/messages?$top=5&$skip=5
GET https://outlook.office.com/api/v2.0/me/messages?$top=5

S’il y a plus de cinq messages dans la boîte de réception, la réponse inclut la propriété odata.nextLink. La présence de cette propriété indique qu’il y a plus d’éléments disponibles sur le serveur. La valeur de cette propriété est un URI qui peut être utilisé pour obtenir les cinq éléments suivants.

GET https://outlook.office.com/api/v2.0/me/messages?$top=5&$skip=5
GET https://outlook.office.com/api/v1.0/me/messages?$top=5

S’il y a plus de cinq messages dans la boîte de réception, la réponse inclut la propriété odata.nextLink. La présence de cette propriété indique qu’il y a plus d’éléments disponibles sur le serveur. La valeur de cette propriété est un URI qui peut être utilisé pour obtenir les cinq éléments suivants.

GET https://outlook.office.com/api/v1.0/me/messages?$top=5&$skip=5

La radiomessagerie est réalisée en utilisant le paramètre $top pour spécifier une taille de page et le paramètre $skip en tant que multiple du format de page. En incrémentant la valeur de paramètre $skip par le format de page, vous pouvez demander la page suivante dans l’ensemble des résultats.

Compter les entités dans une collection

Vous pouvez obtenir le nombre d’entités dans une collection en utilisant le paramètre $count. Vous pouvez également filtrer la demande de comptage.

Cet exemple obtient le nombre de messages dans la boîte de réception.

GET https://outlook.office.com/api/beta/me/messages/$count

Et cet exemple sans codage d’URL obtient le nombre de messages non lus dans la boîte de réception.

GET https://outlook.office.com/api/beta/me/messages/$count?$filter=IsRead eq false

Le même exemple avec l’encodage d’URL :

GET https://outlook.office.com/api/beta/me/messages/$count?$filter=IsRead%20eq%20false

Cet exemple obtient le nombre de messages dans la boîte de réception.

GET https://outlook.office.com/api/v2.0/me/messages/$count

Et cet exemple sans codage d’URL obtient le nombre de messages non lus dans la boîte de réception.

GET https://outlook.office.com/api/v2.0/me/messages/$count?$filter=IsRead eq false

Le même exemple avec l’encodage d’URL :

GET https://outlook.office.com/api/v2.0/me/messages/$count?$filter=IsRead%20eq%20false

Cet exemple obtient le nombre de messages dans la boîte de réception.

GET https://outlook.office.com/api/v1.0/me/messages/$count

Et cet exemple sans codage d’URL obtient le nombre de messages non lus dans la boîte de réception.

GET https://outlook.office.com/api/v1.0/me/messages/$count?$filter=IsRead eq false

Le même exemple avec l’encodage d’URL :

GET https://outlook.office.com/api/v1.0/me/messages/$count?$filter=IsRead%20eq%20false

Coller tour les morceaux

Vous pouvez combiner des paramètres pour créer des requêtes complexes. L’exemple suivant affine une requête des messages dans la boîte de réception des manières suivantes :

  • Renvoyer uniquement les éléments avec Importance réglé sur High.

  • Renvoie seulement les propriétés Subject, Sender, et ReceivedDateTime.

  • Renvoie seulement les cinq premiers messages.

Remarque Le codage d’URL n'est pas utilisé et des sauts de ligne ont été ajoutés pour faciliter la lecture de l’exemple.

https://outlook.office.com/api/beta/me/messages?
    $filter=Importance eq 'High'
    &$select=Subject,Sender,ReceivedDateTime
    &$top=5

Quand vous spécifiez le paramètre $filter, le serveur détermine un ordre de tri pour les résultats. Si vous utilisez les deux éléments $filter et $orderby, les propriétés dans l'élément $filter doit être répertorié en premier dans l’élément $orderby avant toutes les autres propriétés, et elles doivent être répertoriées dans l’ordre où elles apparaissent dans le paramètre $filter. L’exemple suivant montre une requête filtrée par les propriétés Subject et Importance, puis triées par les propriétés Subject, Importance et Sender.

https://outlook.office.com/api/beta/me/messages?
    $filter=Subject eq 'Good Times' AND Importance eq 'High'&
    $orderby=Subject,Importance,Sender

Voici les mêmes exemples avec l’encodage d’URL et sans saut de ligne.

https://outlook.office.com/api/beta/me/messages?$filter=Importance%20eq%20%27High%27&select=Subject,Sender,ReceivedDateTime&$top=5

https://outlook.office.com/api/beta/me/messages?$filter=Subject%20eq%20%27Good%20Times%27%20AND%20Importance%20eq%20%27High%27&$orderby=Subject,Importance,Sender
  • Renvoyer uniquement les éléments avec Importance réglé sur High.

  • Renvoie seulement les propriétés Subject, Sender, et ReceivedDateTime.

  • Renvoie seulement les cinq premiers messages.

Remarque Le codage d’URL n'est pas utilisé et des sauts de ligne ont été ajoutés pour faciliter la lecture de l’exemple.

https://outlook.office.com/api/v2.0/me/messages?
    $filter=Importance eq 'High'
    &$select=Subject,Sender,ReceivedDateTime
    &$top=5

Quand vous spécifiez le paramètre $filter, le serveur détermine un ordre de tri pour les résultats. Si vous utilisez les deux éléments $filter et $orderby, les propriétés dans l'élément $filter doit être répertorié en premier dans l’élément $orderby avant toutes les autres propriétés, et elles doivent être répertoriées dans l’ordre où elles apparaissent dans le paramètre $filter. L’exemple suivant montre une requête filtrée par les propriétés Subject et Importance, puis triées par les propriétés Subject, Importance et Sender.

https://outlook.office.com/api/v2.0/me/messages?
    $filter=Subject eq 'Good Times' AND Importance eq 'High'&
    $orderby=Subject,Importance,Sender

Voici les mêmes exemples avec l’encodage d’URL et sans saut de ligne.

https://outlook.office.com/api/v2.0/me/messages?$filter=Importance%20eq%20%27High%27&select=Subject,Sender,ReceivedDateTime&$top=5

https://outlook.office.com/api/v2.0/me/messages?$filter=Subject%20eq%20%27Good%20Times%27%20AND%20Importance%20eq%20%27High%27&$orderby=Subject,Importance,Sender
  • Renvoyer uniquement les éléments avec Importance réglé sur High.

  • Renvoie seulement les propriétés Subject, Sender, et DateTimeReceived.

  • Renvoie seulement les cinq premiers messages.

Remarque Le codage d’URL n'est pas utilisé et des sauts de ligne ont été ajoutés pour faciliter la lecture de l’exemple.

https://outlook.office.com/api/v1.0/me/messages?
    $filter=Importance eq 'High'
    &$select=Subject,Sender,DateTimeReceived
    &$top=5

Quand vous spécifiez le paramètre $filter, le serveur détermine un ordre de tri pour les résultats. Si vous utilisez les deux éléments $filter et $orderby, les propriétés dans l'élément $filter doit être répertorié en premier dans l’élément $orderby avant toutes les autres propriétés, et elles doivent être répertoriées dans l’ordre où elles apparaissent dans le paramètre $filter. L’exemple suivant montre une requête filtrée par les propriétés Subject et Importance, puis triées par les propriétés Subject, Importance et Sender.

https://outlook.office.com/api/v1.0/me/messages?
    $filter=Subject eq 'Good Times' AND Importance eq 'High'&
    $orderby=Subject,Importance,Sender

Voici les mêmes exemples avec l’encodage d’URL et sans saut de ligne.

https://outlook.office.com/api/v1.0/me/messages?$filter=Importance%20eq%20%27High%27&select=Subject,Sender,DateTimeReceived&$top=5

https://outlook.office.com/api/v1.0/me/messages?$filter=Subject%20eq%20%27Good%20Times%27%20AND%20Importance%20eq%20%27High%27&$orderby=Subject,Importance,Sender
© 2018 Microsoft