Comment récupérer des événements de calendrier avec HTTP GET

Dans ce tutoriel, vous allez apprendre à récupérer une plage spécifique d’événements depuis votre calendrier en utilisant Microsoft Graph API. Cela implique d’effectuer une requête HTTP GET vers l’endpoint Graph API, en ciblant une plage de dates et d’heures particulière.

Prérequis

• Compte Microsoft 365 : vous devez disposer d’un compte Microsoft 365 ayant accès à un calendrier Outlook.
• Autorisations : le compte demandeur doit disposer de l’autorisation Calendars.Read dans Microsoft Graph.
• Jeton d’accès : vous aurez besoin d’un jeton d’accès comportant les autorisations appropriées pour l’authentification. Celui-ci peut être obtenu via OAuth 2.0.

Consultez la documentation Microsoft Graph sur les autorisations pour plus de détails concernant les autorisations et les jetons d’accès.

Entrées d’exécution

Avant de commencer, assurez-vous d’avoir les informations suivantes prêtes :

• StartDateTime : date et heure de début de l’affichage du calendrier.
• EndDateTime : date et heure de fin de l’affichage du calendrier.

Récupération de la vue du calendrier

Étape 1 : Configurer l’action

Ajoutez une nouvelle action à votre flux de travail. Naviguez dans la catégorie « HTTP Integrations » et sélectionnez l’action « HTTP API GET » afin de commencer à récupérer votre vue calendrier pour l’intervalle de temps spécifié.

Étape 2 : Paramétrer la requête HTTP GET

Configuration de l’URL

Utilisez le format d’URL suivant pour votre requête :

https://graph.microsoft.com/v1.0/me/calendarview?startdatetime={startDateTime}&enddatetime={endDateTime}

Remplacez {startDateTime} et {endDateTime} par vos entrées d’exécution réelles. Cette URL comprend des paramètres de requête pour définir la plage temporelle désirée dans la vue du calendrier.

Clé secrète

Incluez la clé secrète pour l’autorisation Microsoft Graph API.

Pour plus d’informations sur la clé secrète, veuillez consulter l’article Envoyer une requête POST.

Actions post-récupération

Une fois votre requête envoyée, vous recevrez une réponse contenant :

• StatusCode : indique si votre requête a bien été reçue et comprise.
• Response : les données réelles renvoyées, généralement au format JSON.
• Headers : informations supplémentaires sur votre réponse.

Les données de réponse peuvent être utilisées comme entrée pour d’autres actions au sein du même flux de travail via des mappages dynamiques.

Pour notre requête de calendrier, la réponse de l’API Graph pourrait ressembler à ceci :

{
  "value": [
    {
      "originalStartTimeZone": "Pacific Standard Time",
      "originalEndTimeZone": "Pacific Standard Time",
      "responseStatus": {
        "response": "accepted",
        "time": "2016-10-19T10:37:00Z"
      },
      "iCalUId": "C3F49BB4B7D7EEE4304DA",
      "reminderMinutesBeforeStart": 15,
      "isReminderOn": true
    }
  ]
}

Ainsi, le mappage dynamique serait :

Vous pouvez exploiter ces données dans les actions suivantes :

Exécution du flux de travail

Après avoir configuré l’action, enregistrez et publiez votre flux de travail. Lors de l’exécution, il vous sera demandé de renseigner les entrées d’exécution définies précédemment.