Présentation de l’API Calendrier Outlook

L’application Calendrier Outlook fait partie du hub de messagerie Outlook dans Microsoft 365 qui vous permet de gérer les e-mails et les contacts, de trouver des informations sur les utilisateurs d’une organisation, de démarrer des conversations en ligne, de partager des fichiers et de travailler en groupes.

Pourquoi intégrer le Calendrier Outlook ?

Les fonctionnalités enrichies du calendrier Outlook et de son API ouvrent de nombreuses opportunités d’application. Les sections suivantes répertorient quelques-unes d’entre elles.

Atteignez des centaines de millions de clients et créez des scénarios enrichis

Plusieurs millions de clients utilisent le Calendrier Outlook pour communiquer efficacement et accomplir leurs tâches. Ils peuvent organiser des réunions, gérer leurs e-mails, trouver des informations sur les contacts et d’autres utilisateurs, et démarrer des conversations ou des réunions en ligne en un seul endroit, que ce soit sur le web, sur les appareils mobiles ou de bureau. Microsoft Graph connecte non seulement des applications au calendrier, au courrier et aux données de contacts de ces clients, mais il permet aussi aux applications d’intégrer le meilleur de Microsoft 365 et de prendre en charge un large éventail de scénarios de productivité et de collaboration.

La plupart des fonctionnalités de l’API de calendrier Outlook s’appliquent aux calendriers de comptes Microsoft personnels et de comptes professionnels ou scolaires.

** Désigne des fonctionnalités qui s’appliquent exclusivement aux calendriers Outlook dans des comptes professionnels ou scolaires.

Automatisez l’organisation des rendez-vous et des calendriers

Les clients apprécient la façon dont Outlook les aide à organiser leur temps au travail, en famille et pour leurs activités personnelles. L’API REST Microsoft Graph assure une parité proche avec l’expérience du client, en permettant aux applications de créer, de gérer et de répondre aux événements naturellement :

  • Dans Outlook, les clients peuvent créer des calendriers individuels pour le travail, leur vie privée et d’autres activités, et de les organiser dans des groupes de calendrier. Ils peuvent activer les calendriers gratuits Anniversaires et Jours fériés pour leur rappeler les anniversaires de leurs contacts et les jours fériés locaux. Ils peuvent ajouter des calendriers qui correspondent à leurs centres d’intérêt, par exemple pour suivre des équipes de sport ou des émissions TV. Les clients peuvent sélectionner et superposer les calendriers pour voir tous leurs événements dans la même vue. Grâce à l’API calendrier, votre application peut organiser les calendriers dans desgroupes de calendriers et interagir avec des calendriers intéressants comme n’importe quel autre calendrier dans la boîte aux lettres de l’utilisateur.

  • Les clients Outlook peuvent appliquer des catégories aux événements, aux messages, aux contacts, aux tâches et aux publications de groupe de façon cohérente pour améliorer l’organisation et l’exploration des données. L’API de calendrier vous permet d’accéder et de définir la liste principale des catégories d’un utilisateur, qui peut laisser libre cours à d’autres scénarios créatifs. Par exemple, un club d’athlétisme qui organise un tournoi sportif peut fournir une application qui différencie les e-mails et les événements de chaque sport selon des catégories de couleur. Pour connaître les informations de dernière minute, par exemple en cas de changement imprévu du planning, l’application peut également définir la propriété importance de ces événements et des e-mails pour avertir les clients.

  • Dans un dossier de calendrier, vous pouvez créer et mettre à jour des événements ponctuels, ou planifier et gérer des événements périodiques. Vous pouvez laisser vos clients répondre aux demandesde réunion et répéter ou ignorerdes rappels à l’aide de la propriété de navigation d’événements associée.

Donnez la possibilité aux clients de rester synchronisés et de connaître le planning de leur journée

L’API de calendrier aide les clients à connaître le planning de leur journée et à améliorer leur productivité :

  • Vous pouvez synchroniser le magasin local de l’application en vous abonnant aux notifications de modification et au suivi des modifications apportées aux événements dans le calendrier d’un utilisateur.
  • Vous pouvez afficher l’agenda de l’utilisateur via un affichage de rappel simplifié.
  • Vous pouvez donner la possibilité à l’utilisateur d’accepter et de participer à une réunion en ligne via la propriété webLink qui ouvre la réunion dans Outlook sur le web.
  • Les utilisateurs peuvent également accepter provisoirement ou refuser une réunion s’ils sont en déplacement.

Facilitez la collaboration

  • Dans Outlook, les clients peuvent partager des calendriers entre eux et accorder des autorisations de lecture, d’écriture ou de suppression du contenu des calendriers. Ils peuvent également déléguer un calendrier pour autoriser un autre client à répondre aux demandes de réunion en son nom. Côté programme, même si vous ne pouvez pas lancer une action de partage ou de délégation au nom d’un utilisateur, vous pouvez utiliser un ensemble de propriétés pour vérifier l’état du partage et activer des scénarios autour des calendriers partagés ou délégués : canEdit, canShare, canViewPrivateItems, isShared et isSharedWithMe.
  • L’API de calendrier vous permet de récupérer des éléments de calendrier de l’utilisateur connecté, ou des utilisateurs qui ont partagé ou délégué leurs calendriers à l’utilisateur connecté. Par exemple, si Claude a partagé un calendrier avec John ou si Claude a délégué l’accès à John, les autorisations déléguées de John vous donne également un accès en lecture au calendrier et au contenu partagés de Claude.
  • La fonctionnalité Groupes Microsoft 365 permet aux membres d’un groupe de collaborer et d’accéder aux conversations de groupe et aux calendriers directement dans Outlook. Hormis quelques différences mineures entre les calendriers de groupe et les calendriers d’utilisateur, l’API de calendrier vous permet d’interagir avec les calendriers de groupe de la même manière qu’avec les calendriers d’utilisateur. Consultez la ressource calendrier pour en savoir plus**.

Planifiez intelligemment

Outlook et l’API de calendrier proposent de nombreux services intelligents pour planifier des événements :

  • Grâce aux paramètres de l’application Calendrier Outlook, les clients peuvent activer l’ajout automatique d’événements à partir des e-mails (réservations de vol, d’hôtel ou de restaurant), ainsi que la facturation automatique. Après les avoir ajouté, vous pouvez interagir avec ces événements comme avec n’importe quel autre objet event dans la boîte aux lettres de l’utilisateur, mais aussi créer des scénarios créatifs qui utilisent cette fonctionnalité d’Outlook.
  • Dans Outlook, réserver une salle de réunion est aussi simple qu’ajouter un participant à l’événement. L’API Calendrier représente une salle de réunion sous la forme d’un objet emailAddress. Vous pouvez obtenir des salles et obtenir les listes de salles disponibles dans un client. Pour organiser une réunion dans une salle spécifique, affectez-la à la propriété location de l’événement.**.
  • Vous pouvez rechercher les informations de disponibilité des utilisateurs et des ressources pour une période donnée. Vous pouvez ensuite appliquer ces données à différents scénarios, notamment de planification de ressources et d’événement.**
  • Si votre scénario implique la planification de réunions à un moment optimal, vous pouvez envisager d’utiliser la fonction findMeetingTimes pour identifier des heures ou des lieux de réunion possibles. La fonction findMeetingTimes tient compte de la disponibilité des participants, des salles et des horaires souhaités, ainsi que d’autres contraintes que vous spécifiez. Si la première tentative ne renvoie pas d’heure de réunion commune, vérifiez la raison, ajustez vos critères et appelez findMeetingTimes une nouvelle fois.**

Organisez des téléconférences à plusieurs endroits et sur plusieurs fuseaux horaires

À l’ère de la mondialisation, les réunions d’entreprise rassemblent aujourd’hui des participants présents dans le monde entier sur plusieurs fuseaux horaires. Voici comment vous pouvez utiliser l’API de calendrier pour gérer ces réunions :

  • Par exemple, dans Outlook, les clients peuvent organiser une réunion et ajouter des participants qui assisteront à la réunion depuis une salle de conférence à Seattle, un café à Paris ou un bureau à domicile en Chine. Côté programme, la propriété locations de l’événement, qui est une collection d’objets location, peut refléter ce niveau de détails dans displayName et locationType pour chaque lieu (location). Consultez un exemple.
  • Outlook offre aux clients la flexibilité nécessaire pour organiser des événements et spécifier un fuseau horaire pour chaque heure de début et de fin d’un événement. Pour parvenir à cette flexibilité, l’API de calendrier renvoie par défaut les heures de début et de fin (start et end) d’un événement (event) au format UTC et fournit les propriétés originalStartTimeZone et originalEndTimeZone pour noter les fuseaux horaires utilisés quand l’événement est créé.
  • Vous pouvez également spécifier l’en-tête Prefer: outlook.timezone="{time zone name}" pour qu’une opération d’événement GET renvoie les horaires de début et de fin (start et end) dans le fuseau horaire spécifié. Le nom du fuseau horaire peut être choisi parmi les noms pris en charge par Windows et les noms répertoriés dans cette liste. Consultez un exemple de l’en-tête Prefer en cours d’utilisation.
  • Les organisations qui prennent en charge les fournisseurs de réunion en ligne, telles que Microsoft Teams et Skype, peuvent configurer les calendriers Outlook pour utiliser ces fournisseurs. Vous pouvez facilement organiser des événements dans ces calendriers et y participer en tant que réunions en ligne.

Créer des applications avec une reconnaissance d’emplacement et fournir un contexte intelligent

Utilisez l'API emplacements pour aider les utilisateurs à accéder à un emplacement ou fournir une solution intelligente basée sur l’emplacement de l’utilisateur. Voici quelques exemples de scénarios :

  • Incorporez des détails dans les événements de calendrier pour aider les utilisateurs à naviguer dans leur journée et à améliorer leur productivité.**
  • Les applications de restauration peuvent utiliser l’API places pour faciliter la navigation et la configuration de la salle.**
  • Automatisez la messagerie électronique des détails de la réunion aux participants et incluez une carte sur la façon d’obtenir une salle.**
  • Configurez les assistants de robot de réception de façon à fournir des informations sur des salles spécifiques dans un bâtiment.**

Selon votre scénario d’application, vous pouvez utiliser l’API emplacements dans le contexte d’Outlook ou indépendamment d’Outlook.

Tirez parti de la veille sur les réseaux sociaux et d’autres services dans Microsoft Graph

Utilisez l’API contacts dans Microsoft Graph pour vous connecter à des données de participants basées sur les modèles de communication et de collaboration d’un utilisateur et les relations commerciales. Vous pouvez implémenter des contrôles tels qu’un sélecteur de personnes et suggérer des personnes pertinentes pour l’utilisateur lors de l’organisation de réunions au nom de l’utilisateur.

Évitez la surcharge de l’application en stockant et en gérant les données d’application dans des magasins de données externes. Avec Microsoft Graph, vous pouvez stocker des données d’application personnalisées sous la forme d’extensions d’ouverture dans les instances de ressource individuelles. Si vous avez besoin que les données soient typées ou que vous souhaitez pouvoir partager le schéma typé, vous pouvez stocker des données d’application personnalisées dans des extensions de schéma.

Où se trouvent les données ?

L’API Microsoft Graph prend en charge l’accès aux données des principales boîtes aux lettres et des boîtes aux lettres partagées des utilisateurs. Les données peuvent être constituées de calendriers, courriers ou de contacts personnels stockés dans une boîte de messagerie sur le cloud d'Exchange Online dans le cadre d’Office 365 ou sur Exchange en local dans un déploiement hybride.

L’API ne prend pas en charge l’accès aux boîtes aux lettres d’archivage , que ce soit sur Exchange Online ou sur Exchange Server.

Référence d’API

Vous recherchez la référence de l’API pour ce service ?