Présentation de l’API Calendrier OutlookOutlook calendar API overview

L’application Calendrier Outlook fait partie du hub de messagerie Outlook dans Office 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.Outlook calendar is part of the Outlook messaging hub in Office 365 that also lets you manage emails and contacts, find information about users in an organization, initiate online conversations, share files, and collaborate in groups.

Pourquoi intégrer le Calendrier Outlook ?Why integrate with Outlook calendar?

Atteignez des centaines de millions de clients et créez des scénarios enrichisReach hundreds of millions of customers and build rich scenarios

Plusieurs millions de clients utilisent le Calendrier Outlook pour communiquer efficacement et accomplir leurs tâches.Many millions of customers use Outlook calendar as part of an integrated hub that lets them effectively communicate and get things done. 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.They can set up meetings, manage emails, find information about contacts and other users, and initiate conversations or online meetings all in one place, be it on the web, mobile, or desktop. 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.Microsoft Graph not only connects apps to the calendar, mail, and contacts data of these customers, it enables apps to integrate with the best of Microsoft 365 and support a wide range of scenarios that enhance productivity and collaboration.

Automatisez l’organisation des rendez-vous et des calendriersAutomate appointment organization and calendaring

Les clients apprécient la façon dont Outlook les aide à organiser leur temps au travail, en famille et pour leurs activités personnelles.Customers like how Outlook lets them organize their time for work, family, and personal activities. 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 :Microsoft Graph REST API keeps close parity with the customer experience, letting apps create, manage, and respond to events just as naturally:

  • 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.In Outlook, customers can create individual calendars for work, family, and other purposes, and organize them in calendar groups. 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.They can turn on the free Birthdays and Holiday calendar to remind them of contacts' birthdays and local holidays. 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.They can add calendars that match their interests, such as calendars for sport teams and TV programs. Les clients peuvent sélectionner et superposer les calendriers pour voir tous leurs événements dans la même vue.Customers can select and overlay calendars, and see their events in the same view. Grâce à l’API de calendrier, votre application peut également organiser les calendriers dans des groupes de calendrier et interagir avec les calendriers intéressants comme avec n’importe quel autre calendrier dans la boîte aux lettres de l’utilisateur.Through the calendar API, your app can similarly organize calendars in calendar groups, and interact with interesting calendars just like any other calendar in the user's mailbox.

  • 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 la découverte des données.Outlook customers can apply categories to events, messages, contacts, tasks, and group posts in a consistent way to enhance organization and disovery. 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.The calendar API lets you access and define a user's master list of categories, which opens up additional creative scenarios. 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.For example, an athletic club can organize a sports tournament and offer an app that differentiates emails and events for each sport with their own color category. 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.For last-minute news such as unforeseen timetable changes, the app can also set the importance property of those events and emails to alert customers.

  • 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.In a calendar folder, you can create and update single instance events, or schedule and maintain recurring events. Vous pouvez donner la possibilité à vos clients de répondre aux demandes de réunion, et de répéter ou d’ignorer les rappels à l’aide de la propriété de navigation associée à l’événement.You can let your customers respond to meeting requests, and snooze or dismiss reminders using the associated event navigation property.

Donnez la possibilité aux clients de rester synchronisés et de connaître le planning de leur journéeHelp customers stay synchronized and navigate their day

L’API de calendrier aide les clients à connaître le planning de leur journée et à améliorer leur productivité :The calendar API helps customers navigate their day and enhance productivity:

  • 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.You can keep the app local store synchronized by subscribing to change notifications and tracking changes to events in a user's calendar.
  • Vous pouvez afficher l’agenda de l’utilisateur via un affichage de rappel simplifié.You can display the user's agenda based on a light-weight reminder view.
  • 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.You can let the user conveniently accept and take a meeting online through its webLink property, which opens the meeting in Outlook on the web.
  • Les utilisateurs peuvent également accepter provisoirement ou refuser une réunion s’ils sont en déplacement.Users can also tentatively accept or decline a meeting while on the go.

Facilitez la collaborationEnhance 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.In Outlook, customers can share calendars with one another and give permissions to read, write, or delete calendar contents. Ils peuvent également déléguer un calendrier pour autoriser un autre client à répondre aux demandes de réunion en son nom.Or, they can delegate a calendar to let another customer respond to meeting requests on their behalf. 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.Programmatically, while you cannot initiate a share or delegate action on behalf of a user, you can use a set of properties to verify the sharing status and enable scenarios around shared or delegated calendars: canEdit, canShare, canViewPrivateItems, isShared, and 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é.The calendar API lets you get calendar items of the signed-in user, or users who have shared or delegated their calendars to the signed-in user. 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.For example, if Garth has shared a calendar with John, or if Garth has delegated access to John, then delegated permissions from John would give you read access to Garth's shared calendar and contents as well.
  • ** La fonctionnalité Groupes Office 365 permet aux membres d’un groupe de collaborer et d’accéder aux conversations de groupe et aux calendriers directement dans Outlook.** Office 365 groups make it convenient for group members to collaborate and access group conversations and calendars right in 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.Aside from a few minor differences between group calendars and user calendars, the calendar API lets you interact with group calendars just like user calendars. Consultez la ressource calendar pour en savoir plus.See the calendar resource for more information.

** Désigne des fonctionnalités qui s’appliquent exclusivement aux calendriers Outlook dans des comptes professionnels ou scolaires.** Denotes features specifically applicable to Outlook calendars in work or school accounts.

Planifiez intelligemmentSchedule smart

Outlook et l’API de calendrier proposent de nombreux services intelligents pour planifier des événements :Outlook and the calendar API offer many smart conveniences to schedule events:

  • 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.Through Outlook calendar app settings, customers can enable automatic adding of events from emails, such as flight, hotel, or dining reservations, and billing invoices. 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.Once added, you can interact with these events just like any other event objects in the user's mailbox, and build creative scenarios upon this Outlook capability.
  • ** Dans Outlook, réserver une salle de réunion est aussi simple qu’ajouter un participant à l’événement.** In Outlook, booking a meeting room is as straight-forward as adding an attendee to the event. L’API Calendrier représente une salle de réunion sous la forme d’un objet emailAddress.The calendar API represents a meeting room as an emailAddress object. Vous pouvez obtenir des salles (préversion) et obtenir les listes de salles (préversion) disponibles dans un locataire.You can get rooms (preview) and get room lists (preview) that are available in a tenant. Pour organiser une réunion dans une salle spécifique, affectez-la à la propriété location de l’événement (event).To organize a meeting in a specific room, assign it to the location property of the event.
  • ** Vous pouvez rechercher les informations de disponibilité des utilisateurs et des ressources pour une période donnée.** You can look up the free/busy information for users and resources for a specific time period. Vous pouvez ensuite appliquer ces données à différents scénarios, notamment de planification de ressources et d’événement.You can then use this data to apply to different scenarios including resource planning and event scheduling.
  • ** 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.** If your scenario involves scheduling meetings at an optimal time, you can consider using findMeetingTimes to identify possible times or locations to meet. 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.The findMeetingTimes function considers the free/busy status of the attendees, and any preferred rooms, time, and other constraints you provide. 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.If the first try doesn't return a common meeting time, check the reason, adjust your criteria and call findMeetingTimes again.

Organisez des téléconférences à plusieurs endroits et sur plusieurs fuseaux horairesTeleconference across multiple locations and time zones

À 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.With globalization, today's business meetings often involve attendees participating from different locations and time zones. Voici comment vous pouvez utiliser l’API de calendrier pour gérer ces réunions :Here's how you can use the calendar API to manage such meetings:

  • 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.As an example in Outlook, customers can organize a meeting and include attendees joining from a conference room in Seattle, a coffee shop in Paris, and a home office in China. 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).Programmatically, the event locations property, which is a collection of location objects, can reflect this level of details in displayName and locationType for each location. Consultez un exemple.See an example.
  • 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.Outlook gives customers the flexibility to organize events and specify a time zone for each of the start and end times of an event. 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éé.To support this flexibility, by default, the calendar API returns the start and end times of an event in UTC, and provides the originalStartTimeZone and originalEndTimeZone properties to note the time zones used when the event was created.
  • 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é.Alternatively, you can specify the Prefer: outlook.timezone="{time zone name}" header so that a GET event operation returns start and end in the time zone you specify. 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.The time zone name can be any of those supported by Windows, as well as those on this list. Consultez un exemple de l’en-tête Prefer en cours d’utilisation.See an example of the Prefer header in use.

Tirez parti de la veille sur les réseaux sociaux et d’autres services dans Microsoft GraphTake advantage of social intelligence and other developer conveniences in Microsoft Graph

Utilisez l’API de contacts dans Microsoft Graph pour vous connecter aux données de contacts issues des modèles de communication et de collaboration d’un utilisateur, ainsi que de ses relations professionnelles.Use the people API in Microsoft Graph to connect to people data which is based on a user's communication and collaboration patterns, and business relationships. Vous pouvez implémenter des contrôles comme le sélecteur de personnes et suggérer des personnes pertinentes pour l’utilisateur quand vous organisez des réunions au nom de l’utilisateur.You can implement controls such as a people picker, and suggest persons relevant to the user when organizing meetings on the user's behalf.

Évitez la surcharge de l’application en stockant et en gérant les données d’application dans des magasins de données externes.Save overhead in storing and managing app data in external data stores. 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.With Microsoft Graph, you can store custom app data as open extensions in individual resource instances. Si vous préférez que les données soient typées ou si vous souhaitez partager le schéma typé, vous pouvez stocker les données d’application personnalisées dans les extensions de schéma.If you require the data to be typed, or would like to be able to share the typed schema, you can store custom app data in schema extensions.

Référence d’APIAPI reference

Vous recherchez la référence de l’API pour ce service ?Looking for the API reference for this service?

Étapes suivantesNext steps